cairn
Cairn es un tracker de trabajo para agentes de IA que registra lo que se lee antes de empezar y lo escribe mientras trabajan, permitiendo rastrear intentos fallidos, conocimientos adquiridos y sesiones completas en un solo lugar.
Ficha actualizada 23 sept 2026, 14:07 · upstream 23 sept 2026, 14:00 · release v0.6.0
Qué es cairn
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Cairn es una herramienta autocontenido que funciona como un registro centralizado de todo lo que los agentes de IA leen antes de iniciar una tarea y lo escriben durante su ejecución. Cada agente puede consultar el historial para evitar repetir trabajo innecesario, ya que recuerda qué se intentó anteriormente. El sistema está diseñado para ser autocontenido: no requiere infraestructura externa ni dependencias complejas.
Cairn funciona como un "tracker" de agentes: registra tareas pendientes, notas durante la ejecución, conocimientos adquiridos y sesiones completas en cuatro almacenes separados (tasks, notes, knowledge, sessions). Un solo comando `cairn check` busca simultáneamente todos estos almacenes para responder a una pregunta.
La arquitectura se basa en tres mecanismos de registro: un briefing al inicio de cada sesión, la consulta del conocimiento existente al leer archivos, y el registro automático de sesiones cuando terminan. Esto elimina la necesidad de que los agentes recuerden manualmente qué ya han hecho.
- Evitar duplicar trabajo repetitivo en equipos con múltiples agentes de IA
- Registrar intentos fallidos y soluciones para evitar errores similares en el futuro
- Documentar conocimiento técnico adquirido durante la ejecución de tareas
- Crear un historial auditable de decisiones tomadas por agentes autónomos
- Permitir que agentes diferentes trabajen sobre proyectos compartidos sin colisiones
- Rastrear sesiones completas con sus hallazgos y conclusiones asociadas
- Cairn funciona como un tracker de memoria para agentes: registra intentos fallidos, conocimientos adquiridos y sesiones completas en un solo lugar
- El comando `cairn check` busca simultáneamente todos los almacenes (tasks, notes, knowledge, sessions) en una sola consulta
- Las resoluciones son obligatorias: al cerrar una tarea se registra explícitamente cómo se resolvió el problema
- Los errores y dead ends son tratados como conocimiento válido que puede ser consultado por agentes futuros
- Cairn no requiere un backend externo ni dependencias de infraestructura compleja, funciona con solo Node.js y Postgres
- El sistema permite múltiples proyectos por tarea y mantiene referencias estables entre sesiones
- No incluye un editor WYSIWYG para escribir notas durante la ejecución (se requiere `cairn note` manual)
- La búsqueda exacta (`--exact`) puede fallar si el texto contiene caracteres especiales o emojis
- El conocimiento se almacena en Postgres y no tiene persistencia local por defecto
- No incluye un sistema de autenticación centralizado ni gestión de permisos granular
- La búsqueda exacta es lenta para grandes volúmenes de datos sin índices optimizados
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instala con `npm install` y ejecuta `node scripts/install-hooks.mjs` para activar los hooks de memoria,Configura el archivo `.env` con la base de datos Postgres, puerto del servidor y rutas de archivos,Crea un proyecto en el directorio raíz y activa el hook de inicio con `CAIRN_HOOK_DEBUG=1` para depurar fallos silenciosos,Para producción, despliega las imágenes Docker oficiales (PostgreSQL + Node.js) o usa un contenedorizado como Kubernetes,El sistema requiere una base de datos Postgres establecida antes del primer agente; no soporta migración automática,Recomendado desplegar en un entorno aislado para pruebas, ya que el conocimiento se almacena permanentemente y puede afectar a agentes futuros
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.