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

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

The cairn task board, dependency graph, and Connect page


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

ComoPara que usar
Aplicativo de desktopDownload (macOS / Windows / Linux)Uma janela nativa + bandeja; atualizações automáticas
Interface webcairn web --repo .O quadro no seu navegador
Servidor MCPcairn 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.