Lunes, 16 de noviembre de 2026
Portada de las 21:50
Todos los periódicos y la radio, en unoEscrito por IA a partir de Hacker News · Cómo se hace
Hacker News
Show HN

Show HN: Gauge, una CLI open source para mejorar tu documentación de forma recursiva

Gauge publica en abierto su CLI para optimizar documentación, Skills y otras superficies pensadas para agentes de programación. Ejecuta agentes reales contra tu producto, detecta dónde se atascan y permite probar correcciones antes de publicarlas. Funciona en local con Docker y sin cuenta.

Foto: vía github.com

Leer el artículo aquíArtículo original (github.com) 4 comentarios en Hacker News

Escucha la noticia3 min

Evan, de Gauge, presenta la CLI como un bucle de «hillclimbing»: se definen tareas que un agente de programación necesitaría hacer con tu documentación (por ejemplo, «configurar los checks de CI de Gauge»), se ejecutan, se analizan las transcripciones de las sesiones en busca de fricciones o fallos, se crean variantes de la documentación que los resuelvan y se repiten las tareas con esas variantes inyectadas de forma transparente, bajo el mismo hostname. El proceso se repite hasta dar con una variante que resuelva los problemas. El mismo bucle sirve para Skills, CLIs y otras superficies orientadas a agentes.

El diseño se apoya en dos piezas: máquinas virtuales y un gateway de red. Las VM dan mucho privilegio al agente dentro de su entorno, para que sea representativo del agente de un desarrollador, e incluyen el arnés del agente, toolchains de lenguajes y un repositorio git. El gateway termina el TLS, sustituye las variantes de la documentación y reemplaza credenciales, de modo que los agentes ven marcadores de posición y no pueden exfiltrar claves. En el backend local, las VM son contenedores Docker y el gateway es mitmproxy en un contenedor auxiliar por sesión; la inferencia sigue siendo remota.

Según el README, Gauge admite Claude Code, Codex, Pi y OpenCode, y puede usar los inicios de sesión nativos de Claude y Codex o claves de API. Requiere Node.js 22.13+, npm y Docker con contenedores Linux. En modo local se soportan Skills, SDKs, CLIs y archivos; la computación alojada añade documentación, MCP autenticados y APIs autenticadas. La instalación es `npm i -g @withgauge/cli`, y el flujo incluye `gauge init --local`, `gauge run` y `gauge run compare` para contrastar lotes de ejecuciones antes y después de un cambio.

El equipo cuenta que usó el bucle internamente para corregir errores como precios equivocados, limitaciones inexistentes del producto y soluciones alternativas repetidas. Por ejemplo, vieron que los agentes decían que Gauge solo soportaba Claude Code y Codex, rastrearon el origen en las páginas web que consultaban y lo corrigieron. Con Clerk, dicen haber ayudado a mover a los agentes del modo «keyless» heredado al nuevo comando `clerk init`, y tras el despliegue observaron tres veces más agentes usándolo. Al final preguntan si alguien ha montado algo parecido por su cuenta y qué habría que cambiar para que esto fuera una mejora.

En Hacker News

«Show HN: Gauge – Open-Source CLI to recursively improve your docs» · puesto 30 · 24 puntos · enviado por 0x63_Problems

Lo que dicen los comentarios

La conversación es mínima: solo hay un comentario, que no entra en el fondo de la herramienta sino en una cuestión de redacción. Señala que el título habla de mejorar la documentación «recursivamente» cuando el propio README del proyecto llama al proceso «iteración». No hay, por tanto, discusión técnica ni respuesta a las preguntas de los autores sobre alternativas caseras.

Pregunta sobre esta noticia

Respuestas automáticas a partir de las noticias de El Autómata, sus fuentes y la radio. Pueden contener errores: comprueba los enlaces.

Esta noticia la ha redactado una inteligencia artificial a partir de las fuentes citadas, con el criterio editorial de El Autómata (equilibrio, atribución y solo hechos publicados). Puede contener errores: consulta las fuentes originales. Modelo: claude-sonnet-5.5.