Hoy lanzamos OpenWiki, un agente y CLI de código abierto para generar y mantener documentación de bases de código.
Los agentes escriben mejor código cuando entienden el repositorio en el que trabajan. Necesitan saber dónde reside la lógica clave, cómo se conectan los archivos y qué patrones espera la base de código. Una buena documentación les brinda ese contexto a los agentes, lo que lleva a cambios de código más informados y menos errores evitables.
El problema es que la documentación es difícil de mantener actualizada. Escribir la documentación inicial lleva tiempo, y actualizarla cada vez que el código cambia es aún más difícil. En repositorios grandes con PRs frecuentes, la documentación puede quedar desactualizada rápidamente.
OpenWiki se encarga de ese trabajo automáticamente. Crea una wiki para tu repositorio, conecta esa wiki a tu agente de codificación y la mantiene actualizada a medida que tu código cambia.
Por qué wikis para agentes
Nos inspiramos en trabajos existentes sobre wikis de bases de código, incluyendo DeepWiki, AutoWiki y el concepto de LLM Wiki de Karpathy. La idea compartida es simple. Una wiki ofrece a humanos y agentes una forma estructurada de entender una base de código sin forzar todo el contexto en un solo archivo gigante.
Eso es importante porque la mayoría de los agentes de codificación ya leen archivos como AGENTS.md o CLAUDE.md para obtener instrucciones. Esos archivos son útiles, pero no son el lugar adecuado para almacenar cientos de páginas de documentación del repositorio. Deberían señalar al agente hacia el contexto correcto y luego dejar que el agente recupere lo que necesita.
OpenWiki sigue ese modelo. Genera una wiki del repositorio y luego actualiza tus archivos de instrucciones del agente con una referencia a esa wiki. A partir de ahí, tu agente de codificación puede descubrir y usar la documentación automáticamente.
Primeros pasos
OpenWiki está diseñado para ser fácil de ejecutar desde la línea de comandos.
Instálalo con NPM:
1npm install -g openwiki
luego ejecuta:
1openwiki --init
El comando init solicita un proveedor de modelo y una clave API, y luego genera documentación para tu repositorio.
OpenWiki admite proveedores de modelos tanto abiertos como cerrados, incluyendo OpenRouter, Fireworks, Baseten, OpenAI y Anthropic. Por defecto, usa OpenRouter con un modelo abierto, pero puedes configurar el proveedor que mejor funcione para tu configuración.
Debido a que OpenWiki está construido sobre DeepAgents, también admite trazabilidad hacia LangSmith. Si proporcionas una clave API de LangSmith, OpenWiki rastreará las ejecuciones en un proyecto de LangSmith para que puedas inspeccionar exactamente lo que hizo el agente mientras generaba o actualizaba tu documentación.
Cómo se conecta OpenWiki a tu agente de codificación
Después de generar la wiki, OpenWiki actualiza los archivos de instrucciones del agente de tu repositorio. Si tu repositorio usa AGENTS.md, CLAUDE.md o ambos, OpenWiki añade una referencia a la wiki generada y explica cuándo el agente debería usarla.
Elegimos este enfoque porque poner toda la wiki dentro de un archivo de instrucciones añadiría demasiado contexto. En un repositorio grande, la wiki puede abarcar cientos de archivos. Cargar todo eso en cada ejecución del agente sería ineficiente y difícil de mantener.
Una referencia corta funciona mejor. Tu agente de codificación ya lee el archivo de instrucciones. Una vez que OpenWiki añade la referencia, el agente puede encontrar la wiki cuando necesite contexto del repositorio, sin requerir que cambies tu flujo de trabajo.
Mantener la wiki actualizada
Generar documentación una vez es útil. Mantenerla actualizada es donde OpenWiki se vuelve más valioso.
OpenWiki incluye una Acción de GitHub que se puede ejecutar programadamente, por ejemplo una vez al día. La acción ejecuta OpenWiki con la bandera de actualización. OpenWiki verifica qué commits se realizaron desde la última ejecución, usa los diffs de git para entender qué cambió y luego actualiza la wiki con el contexto relevante.
Eso significa que el flujo de trabajo puede ejecutarse en segundo plano. A medida que tu base de código cambia, OpenWiki actualiza la documentación. Tu agente de codificación sigue recogiendo la wiki más reciente a través de la referencia existente en el archivo de instrucciones.
Construido para bases de código primero
Este primer lanzamiento se centra en wikis para bases de código. El objetivo es facilitar que los agentes entiendan los repositorios en los que trabajan, sin pedir a los desarrolladores que escriban y mantengan manualmente documentación detallada.
Con el tiempo, creemos que el concepto de OpenWiki puede aplicarse de manera más amplia. Los agentes necesitan contexto duradero para muchos tipos de trabajo, no solo para codificar. La documentación de la base de código es el primer caso de uso, pero el mismo patrón puede ayudar a los agentes a mantener un contexto útil en otros flujos de trabajo también.
Pruébalo
OpenWiki es de código abierto y está disponible ahora.
Puedes instalarlo, ejecutar openwiki --init y generar una wiki para tu repositorio en unos minutos.
Mira el repositorio aquí: https://github.com/langchain-ai/openwiki y ve el video tutorial: https://youtu.be/nIVu3zfYprI
