CodeAlmanac - Un wiki de bases de código para agentes de programación con IA

• Un wiki vivo que registra decisiones, flujo, invariantes y trampas (gotchas) que no pueden plasmarse solo con código, para dar contexto a los agentes de IA
  • Registra por qué el sistema tiene su forma actual, qué se rompió en el pasado y cómo el flujo de trabajo atraviesa archivos/servicios
• El wiki se guarda como archivos Markdown dentro del repositorio y, tras indexarse localmente, puede revisarse en Git como si fuera código
• Los agentes y las personas usan los mismos comandos locales de lectura: search, show, topics, health, validate
  • Soporta búsquedas por ruta de archivo con search --mentions src/checkout/, y se puede consultar otro wiki con --wiki <name>
• Las tareas del ciclo de vida para mantener el wiki actualizado se ejecutan con tres agentes explícitos: build / ingest / garden
  • Usa el Yoke SDK, publicado por separado
  • ingest: integra al wiki archivos, directorios, Git diff, rangos de commits, PR/issues de GitHub, URL y transcripciones de agentes locales
  • garden: ordena páginas antiguas, enlaces débiles, temas, páginas duplicadas, etc.
• Para no tener que recordar comandos de mantenimiento, ofrece 3 tipos de tareas locales en segundo plano con macOS launchd
  • Sync (cada 5 horas): escanea conversaciones recientes de Codex/Claude y las encola para ingest en el wiki correspondiente
  • Garden (cada 24 horas): revisa conocimiento envejecido/duplicado/con mala conexión en todos los wikis registrados
  • Update (cada 24 horas): actualiza automáticamente el CLI solo en momentos seguros y omite la actualización si hay tareas del ciclo de vida en curso
• Se ejecuta completamente en local, no como servicio hospedado ni con sincronización en la nube; los logs se guardan en ~/.codealmanac/logs/
• El historial de ejecución queda como registro local de trabajos, así que puede consultarse aunque cierres la terminal
  • jobs, jobs show, jobs logs, jobs attach, jobs cancel
  • Se puede integrar con scripts usando --json
• El provider usa almanac-yoke como punto de entrada único; Codex usa app-server y Claude usa Python Agent SDK
  • Reutiliza las sesiones OAuth existentes de Codex/Claude Code
• El visor local que se levanta con serve es solo de lectura y renderiza navegación de páginas/búsqueda/temas/backlinks/referencias de archivos
• Los agentes del ciclo de vida operan con permisos amplios de sistema de archivos no interactivos
  • La carpeta almanac/ no es un sandbox del SO, sino una política de instrucciones/commits, así que solo debe ejecutarse en repositorios confiables
• La telemetría es opcional. No envía código/rutas/prompts/transcripciones/credenciales, desactiva GeoIP y también puede bloquearse con DO_NOT_TRACK=1
• Licencia Apache-2.0