Um segundo cérebro que os seus agentes também leem

• Markdown e git seus

  As notas são arquivos .md numa pasta comum. Você lê e edita no Obsidian ou em qualquer editor. Não há banco de dados que só o Cabeção entende.

• Qualquer provedor

  GitHub, GitLab, Bitbucket, Gitea, um servidor seu ou só a sua máquina. O Cabeção usa o git e as credenciais que você já tem; não depende da API de nenhum provedor.

• Agentes por MCP

  Um servidor MCP local entrega aos agentes busca, grafo, fatos com validade no tempo e ferramentas para gravar memórias, com regras que eles não conseguem contornar.

• Tudo reversível

  Cada gravação é um commit identificado. cabecao undo desfaz uma operação ou uma sessão inteira de um agente, sem reescrever o histórico.

1. 01

   Crie o cérebro

   Um comando, sem perguntas: ele cria a estrutura no repositório vazio, monta o índice local e registra o servidor MCP nos clientes de IA que encontrar.

   $ cabecao init git@github.com:voce/cerebro.git --machine notebook
   Pronto. Seu cérebro está em ~/cabecao (máquina notebook) e em git@github.com:voce/cerebro.git.
   
   Repositório vazio: estrutura do cérebro criada na branch main e enviada para git@github.com:voce/cerebro.git.
   Índice local: 0 notas indexadas em 2 ms.
   
   Agentes:
     Codex   servidor MCP registrado em ~/.codex/config.toml
     Cursor  servidor MCP registrado em ~/.cursor/mcp.json
     Reinicie os agentes que estiverem abertos para eles enxergarem o Cabeção.
   

2. 02

   O agente lembra

   Numa sessão do Claude Code, você pede "guarde que os testes de pagamento só passam com TZ=UTC". O agente chama a tool remember, e a resposta é uma nota nova e um commit.

   remember

   {
     "op": "01M79DRQR9648E1JZ60MF0EBNN",
     "path": "memory/gotchas/testes-de-pagamento-precisam-do-fuso-fixo.md",
     "action": "add",
     "commit": "1af64e1dc48f5627dd086474c571b22326eaa3c0"
   }
   

3. 03

   Volta quando precisa

   Na próxima sessão, em qualquer máquina, a nota volta no recall do agente. E também pelo terminal, na busca.

   $ cabecao search "testes pagamento"
   1 resultado(s) para "testes pagamento", com todos os termos (validade em 2026-11-13):
   
   1. Testes de pagamento precisam do fuso fixo  [gotcha · project:pagamentos]  vigente
      memory/gotchas/testes-de-pagamento-precisam-do-fuso-fixo.md
      Os «testes» do serviço de pagamentos falham perto da meia-noite se o fuso não for fixo. Rode com `TZ=UTC npm test`.
   

As notas ficam numa pasta comum, versionada com git. Os agentes leem e gravam por um servidor MCP que roda na sua máquina, e cada gravação vira um commit. O sync leva tudo ao seu repositório e dali às outras máquinas.