Cairn
Um grafo de tarefas nativo do repositório como arquivos Markdown simples, servido para agentes de IA via MCP e para humanos por meio de uma interface web limpa.
Documentação
cairn
Gerenciamento de tarefas nativo do repositório. Um grafo de tarefas que seus agentes e você compartilham.
Download · Documentação · Conectar um agente · SPEC · Changelog

cairn é um grafo de tarefas que vive como arquivos Markdown no seu repositório. Um único binário Go
(cairn) o serve para agentes de IA via MCP e para humanos por meio de
uma interface web limpa. Uma única fonte de verdade: os arquivos. Um único conjunto de regras: internal/task. Sem banco de dados.
- Vive no seu repositório. Uma tarefa é Markdown (frontmatter YAML para a máquina, corpo em prosa para humanos). Tarefas ramificam, mesclam e são revisadas como código; o histórico de uma tarefa é o seu histórico git.
- Feito para agentes. Agentes listam trabalho pronto, reivindicam-no, executam uma sessão observável com heartbeats e entregam para revisão. Cada escrita é carimbada com o ator que a fez.
- Um conjunto de regras, duas interfaces. A interface web e o servidor MCP são adaptadores finos sobre o mesmo motor, então um agente e um humano sempre veem os mesmos portões e a mesma prontidão.
- Conecte qualquer agente com um clique. A página Connect detecta agentes instalados e escreve a configuração MCP para você, cada um sob sua própria identidade.
Início rápido
make build # -> bin/cairn
cairn web --repo . # open the board in your browser
Em seguida, abra a página Connect e configure um agente com um clique, ou faça manualmente:
claude mcp add cairn -- "$(pwd)/bin/cairn" serve --actor agent:claude --repo "$(pwd)"
Passo a passo completo: Instalação → Início rápido.
Execute do seu jeito
| Como | Para que usar | |
|---|---|---|
| Aplicativo de desktop | Download (macOS / Windows / Linux) | Uma janela nativa + bandeja; atualizações automáticas |
| Interface web | cairn web --repo . | O quadro no seu navegador |
| Servidor MCP | cairn serve --actor agent:x --repo . | Sem interface, iniciado por um agente |
Agentes suportados
Conexão com um clique para Claude Code, Cursor, Codex, Windsurf, OpenCode, Kilo Code e Pi; um guia de copiar e colar para Antigravity e qualquer outro cliente MCP. Veja o guia de Agentes.
Desenvolvimento
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 repositório usa cairn na prática: seu próprio trabalho é rastreado em .cairn/. Veja
AGENTS.md e .cairn/WORKFLOW.md.
Segurança
cairn é uma ferramenta local, de usuário único, sem autenticação por design. Veja SECURITY.md para o modelo de confiança e como relatar uma vulnerabilidade.
Licença
MIT.