CodeAlmanac es una herramienta de línea de comandos para macOS que mantiene una wiki viva dentro del propio repositorio, escrita en Markdown y versionada con Git. Su objetivo es dotar a agentes de codificación con contexto que el código por sí solo no transmite: decisiones de diseño, flujos entre archivos y servicios, invariantes relevantes y errores conocidos. La instalación se realiza con uv tool install codealmanac@latest y requiere Python 3.12 o superior, además de Codex o Claude Code como motor de IA.
Tras la instalación con codealmanac setup, el sistema configura instrucciones globales para el agente elegido y tres tareas programadas en launchd: sincronización cada cinco horas (escanea conversaciones recientes de Codex y Claude para extraer conocimiento), mantenimiento cada 24 horas (revisa páginas obsoletas, duplicadas o mal enlazadas) y actualización automática del CLI. Todo el trabajo se ejecuta en local y los registros se almacenan en ~/.codealmanac/logs/.
El flujo principal se apoya en tres agentes explícitos del SDK Yoke: build, ingest y garden. ingest incorpora al wiki archivos, directorios, diffs de Git, commits, pull requests, issues, URLs o transcripciones de agentes; garden mejora el grafo de conocimiento existente y puede dejar el wiki sin cambios si no hay información duradera que añadir; init crea la wiki si no existe. Comandos como search, show, topics, health y validate permiten a agentes y humanos consultar el mismo repositorio local, y serve ofrece un visor web.
La telemetría es opcional, anónima y no envía código, rutas ni credenciales. CodeAlmanac opera como un agente de confianza sin sandbox del sistema operativo, por lo que los autores recomiendan ejecutar los comandos de ciclo de vida solo en repositorios donde se acepte ese modelo y revisar los diffs resultantes.