OpenWiki - CLI para escribir y mantener documentación para agentes en codebases

 (github.com/langchain-ai)
14 puntos por xguru 1 일 전 | 3 comentarios | Compartir por WhatsApp
  • Herramienta de documentación creada específicamente para agentes, para escribir y mantener un wiki de una codebase o una memoria con fines específicos
  • Importa fuentes de conocimiento locales mediante conectores integrados o repositorios Git y las unifica en un solo wiki local
  • Ofrece dos modos
    • Modo Personal: construye un wiki de cerebro personal en ~/.openwiki/wiki usando como fuentes repos locales, Gmail, Notion, Web Search, Hacker News, X y más
    • Modo Code: genera documentación del repositorio para la codebase actual en openwiki/
  • Actualización automática de documentación con integración CI; incluye workflows de ejemplo para GitHub Actions/GitLab CI para crear automáticamente PR/merge requests de actualización de documentos
  • Genera bundles en Google Open Knowledge Format (OKF) v0.1 en ambos modos; los documentos conceptuales usan YAML front matter con un campo type y expresan relaciones con enlaces Markdown
  • En cada ejecución de code mantiene AGENTS.md y CLAUDE.md en la raíz del repositorio para orientar a los agentes de programación a consultar el wiki al buscar contexto
    • Si ya existen archivos, solo actualiza el bloque <!-- OPENWIKI:START -->…<!-- OPENWIKI:END --> y conserva el resto
  • Los conectores locales admiten recolección desde repositorios Git, Notion, Gmail, X, Web Search y Hacker News, y el mismo conector puede configurarse en varias instancias
  • Compatible con varios proveedores de inferencia: OpenAI, OpenRouter, Gemini(AI Studio), Gemini Enterprise(Vertex AI), Nebius Token Factory, Fireworks, Baseten, NVIDIA NIM, compatibles con OpenAI, AWS Bedrock y Anthropic
    • El valor predeterminado de onboarding es gpt-5.6-terra de OpenAI, y ofrece métodos de autenticación por proveedor como inicio de sesión de ChatGPT, credenciales IAM y Google ADC
  • Recopila telemetría anónima por defecto (a nivel de comandos/resultados/proveedor/nombre de conector), pero no recopila contenido de archivos, credenciales, prompts, salidas del modelo ni IP; puede desactivarse con OPENWIKI_TELEMETRY_DISABLED=1 o DO_NOT_TRACK=1
  • Se instala con npm install -g openwiki
  • Licencia MIT

Lecturas relacionadas

3 comentarios

 
laeyoung 1 일 전

Quería probarlo, pero la parte de recopilar telemetría anónima por defecto (a nivel de comandos/resultados/proveedores/nombres de conectores) sí me deja un poco con sabor amargo. Dicen que se puede desactivar, pero parece que mucha gente no revisa bien esos detalles y simplemente usa la configuración predeterminada.
 
superl3 23 시간 전

Dicen que se puede desactivar con OPENWIKI_TELEMETRY_DISABLED=1 o DO_NOT_TRACK=1
¿es que no confían en eso?
 
laeyoung 20 시간 전

Se puede desactivar, pero como por defecto es opt-in, creo que mucha gente lo usará tal cual por defecto.

Si me imagino recomendándoselo a un colega o a un amigo, normalmente diría "OpenWiki está bueno, pruébalo", no "OpenWiki está bueno, pero puedes desactivar la recolección de datos con OPENWIKI_TELEMETRY_DISABLED=1 o DO_NOT_TRACK=1, así que actívalo y úsalo" :(

Por cierto, yo había entendido comando y resultado como Prompt y Output. Pero al volver a leer el texto original, veo que no era así. Entonces, ¿tal vez esté bien?!