Cairn

cairn

Gestión de tareas nativa del repositorio. Un único grafo de tareas que tú y tus agentes compartís.

Descargar · Documentación · Conectar un agente · SPEC · Changelog

---

cairn es un grafo de tareas que vive como archivos Markdown en tu repositorio. Un único binario Go (cairn) lo sirve a los agentes de IA mediante MCP y a los humanos mediante una interfaz web limpia. Una única fuente de verdad: los archivos. Un único conjunto de reglas: internal/task. Sin base de datos.

• Vive en tu repositorio. Una tarea es Markdown (frontmatter YAML para la máquina, cuerpo en prosa para los humanos). Las tareas se ramifican, fusionan y revisan como código; el historial de una tarea es su historial de git.
• Diseñado para agentes. Los agentes listan el trabajo disponible, lo reclaman, ejecutan una sesión observable con heartbeats y lo entregan para revisión. Cada escritura lleva la marca del actor que la realizó.
• Un conjunto de reglas, dos interfaces. La interfaz web y el servidor MCP son adaptadores ligeros sobre el mismo motor, de modo que un agente y un humano siempre ven las mismas compuertas y la misma preparación.
• Conecta cualquier agente con un clic. La página Connect detecta los agentes instalados y escribe su configuración MCP por ti, cada uno con su propia identidad.

Inicio rápido

make build              # -> bin/cairn
cairn web --repo .      # open the board in your browser

Luego abre la página Connect y configura un agente con un clic, o hazlo manualmente:

claude mcp add cairn -- "$(pwd)/bin/cairn" serve --actor agent:claude --repo "$(pwd)"

Guía completa: Instalación → Inicio rápido.

Ejecútalo a tu manera

	Cómo	Úsalo para
Aplicación de escritorio	Descargar (macOS / Windows / Linux)	Una ventana nativa + bandeja; actualizaciones automáticas
Interfaz web	cairn web --repo .	El tablero en tu navegador
Servidor MCP	cairn serve --actor agent:x --repo .	Sin interfaz, lanzado por un agente

Agentes compatibles

Conexión con un clic para Claude Code, Cursor, Codex, Windsurf, OpenCode, Kilo Code y Pi; una guía de copiar y pegar para Antigravity y cualquier otro cliente MCP. Consulta la Guía de agentes.

Desarrollo

make check       # gofmt + go vet + go test ./...
make web-dev     # Vite dev server (proxies /api -> :8080)
make desktop-dev # native window against a dev server

Este repositorio usa cairn en producción: su propio trabajo se rastrea en .cairn/. Consulta AGENTS.md y .cairn/WORKFLOW.md.

Seguridad

cairn es una herramienta local, de un solo usuario sin autenticación por diseño. Consulta SECURITY.md para conocer el modelo de confianza y cómo reportar una vulnerabilidad.

Licencia

MIT.