Instalação

Requisitos

Programa	Versão	Por quê
Node.js	22.16 ou mais nova. Recomendado: 24	O índice local usa o node:sqlite com busca de texto (FTS5), que só existe a partir da 22.16. A linha 23, que já saiu de suporte, é a única exceção: não tem essa busca.
git	2.38 ou mais novo	O sync integra as mudanças em memória, sem rebase pela metade.

Confira o que você tem:

node --version
git --version

Com uma versão de Node fora da faixa, o Cabeção não roda e diz o que fazer:

cabecao precisa de Node.js 22.16 ou mais novo. Versão atual: v20.12.2. Atualize em https://nodejs.org

Instalar

O Cabeção é publicado no npm com o nome cabecao.

Global (recomendado)

npm i -g cabecao
cabecao --version

1.0.0

Com a instalação global, o registro nos clientes de IA aponta direto para o Node e para o arquivo do Cabeção, sem passar pelo npx a cada sessão.

Sem instalar (npx)

npx cabecao init git@github.com:voce/cerebro.git

Funciona, mas os clientes de IA ficam registrados como npx -y cabecao@<versão> mcp: cada sessão nova passa pelo npx, que leva de 0,5 a 1,4 s para começar. Para trocar depois, instale globalmente e rode cabecao install-client --all.

O pacote não tem dependências de runtime nem binários nativos: é um único bundle JavaScript.

Crie o repositório do cérebro

Antes do init, crie um repositório vazio e privado no provedor que você usa (GitHub, GitLab, Bitbucket, Gitea ou um servidor próprio). Copie o endereço do botão "clonar". Pode ser SSH (git@...) ou HTTPS.

Use um repositório privado

O código do Cabeção é público; o seu cérebro não deve ser. Em HTTPS de um provedor conhecido, o init e o doctor avisam se o repositório parecer público.

Se você ainda não quer um remoto, dá para começar só local e ligar um depois. Veja Criar ou conectar um cérebro.

Próximo passo

Criar ou conectar um cérebro com cabecao init.