Original en inglés: https://argusic.com/subject/codealmanac
codealmanac
Un wiki de base de código para AI coding agents. Captura lo que el código no puede decir: decisiones, flujos, invariantes, trampas.
Funcionafuente: GitHubsitio webTypeScriptApache-2.0commit 0f153501f40a
TypeScript, licencia Apache-2.0. El proyecto se describe a sí mismo como: ai, claude, cli, codebase, codex, coding agents, developer tools y documentation.
codealmanac funciona. Un agent de Argusic lo instaló en 0,5 minutos y no encontró ningún error en una máquina limpia sin GPU, y toda la sesión quedó grabada.
The codealmanac package is installed and functional: CLI responds to --help and --version, all 564 pytest tests pass, ruff lint passes, and doctor reports a healthy install with 71 indexed wiki pages.
Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide
Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 100 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).
De un vistazo
Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.
Qué se midió
De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.
- Tiempo de instalación
- menos de un minuto
- De máquina en frío a terminar
- 8 minutos
- Errores encontrados y corregidos
- 0 encontrados, 0 corregidos sin ayuda humana
- Cómo se demostró el resultado
- uv run pytest --tb=short exited 0, 564 passed in 267.5s; codealmanac --version returned 'codealmanac 0.4.7'; codealmanac doctor showed no problems; ruff check . passed
- Tokens de modelo usados
- 49.285
- Commit exacto probado
- 0f153501f40a
- Imagen del contenedor
- sha256:cdd920bce783
Qué no se midió
La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.
- Memoria de GPU máxima
- se ejecutó en una máquina con CPU, así que no había GPU que muestrear
- Comportamiento en una ejecución larga
- cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga
El final de la grabación
Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.
## Current wiki ◇ repo: /work/repo ✓ registered as 'repo' (almanac) ✓ index: 71 pages, 34 topics (71 files seen) ✓ health: 0 problems Everything works. Let me compile the result: exec /bin/sh -lc 'echo "Install time estimate: uv tool install took ~3.6s + 2 venv setups, tests took 26… succeeded in 0ms: Install time estimate: uv tool install took ~3.6s + 2 venv setups, tests took 267.5s tokens used 49,285
Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.
Cómo se probó
Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.
Puntos fuertes y límites
Hechos medidos, no opiniones. Cómo se redacta.
Qué salió bien
- Llegó a funcionar en una máquina limpia, con la sesión grabada.
- Se instaló en 0,5 minutos, más rápido que la mediana de los 230 proyectos comparables que ha medido Argusic.
- Nada se rompió por el camino: cero errores entre el clon y el funcionamiento.
- Funcionó sin GPU, así que no necesita una para arrancar.
- Licencia Apache-2.0, según su plataforma de origen.
Qué no salió bien, o no se sabe
- Medido una sola vez hasta ahora. Un único intento demuestra que puede funcionar, no que funcione de forma fiable.
De los 231 proyectos de ai que Argusic ha instalado y cronometrado, codealmanac fue el 14.º más rápido en llegar a funcionar, y 152 de 231 llegaron a funcionar.
Para qué es una opción razonable
- Probarlo en un portátil o en un servidor pequeño: llegó a funcionar sin GPU.
- Una evaluación rápida: estaba funcionando 0,5 minutos después del clon.
- Seguir su propio README: el camino documentado funcionó sin nada que arreglar.
También probados, en la misma área
Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.
Historial de ejecuciones
Temas (de GitHub)
aiclaudeclicodebasecodexcoding-agentsdeveloper-toolsdocumentationknowledge-basetypescriptwiki
Insertar el badge
Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.
[](https://argusic.com/subject/codealmanac)Preguntas
- ¿Funciona codealmanac?
- Sí. codealmanac funciona. Argusic lo instaló y lo inició en una máquina limpia en 1 minutos, con 0 errores por el camino, y grabó la sesión.
- ¿Cómo probó Argusic codealmanac?
- En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit 0f153501f40a. Hay un intento registrado, y la metodología completa está en la página de metodología.
- ¿Cuánto costó probar codealmanac?
- La ejecución que produjo este veredicto costó 0,03 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
- ¿Cuánto tarda codealmanac en instalarse?
- 0,5 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
- ¿Necesita codealmanac una GPU?
- No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
- ¿Qué falla al instalar codealmanac?
- Nada, en la ejecución registrada: cero errores entre el clon y el funcionamiento.
- ¿Cómo se compara codealmanac con las alternativas?
- De los 231 proyectos de ai que Argusic ha instalado y cronometrado, codealmanac fue el 14.º más rápido en llegar a funcionar, y 152 de 231 llegaron a funcionar.
- ¿Dónde está la evidencia de codealmanac?
- La ejecución registrada está en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.