Perguntas frequentes

É um GraphRAG?

Não no sentido usual. Um GraphRAG costuma usar um modelo de linguagem para extrair entidades e relações de documentos e montar um grafo à parte. O Cabeção não usa modelo para montar o grafo: ele sai do que já está nas notas (wikilinks, relações tipadas no frontmatter, fatos, substituições e menções a títulos de outras notas), e as notas continuam sendo a fonte da verdade. Quem raciocina sobre a busca é o agente que você já usa; se quiser uma resposta pronta, com citações conferidas, ative o ask, que é opcional.

Preciso do GitHub?

Não. Qualquer remoto git serve: GitHub, GitLab, Bitbucket, Gitea, Codeberg, um servidor seu por SSH ou até uma pasta em outro disco. O Cabeção não usa a API de nenhum provedor, só o git. E dá para usar sem remoto nenhum, só na sua máquina.

Meus dados vão para algum servidor?

Só para o remoto git que você configurou, quando você (ou um agente) roda o sync. O Cabeção não tem servidor próprio, conta nem telemetria. O que um agente lê do cérebro passa a fazer parte da conversa com o modelo de IA do seu cliente, como qualquer outro texto. Detalhes em Segurança e privacidade.

A única exceção é opcional: se você ativar as respostas com um modelo de linguagem (cabecao llm on), cada ask manda trechos das notas ao provedor que você escolheu (ou a um servidor na sua máquina, como o Ollama). Vem desligado; notas privadas (private: true, a tag private ou private/..., ou #private no corpo), o nome delas e trechos com segredo nunca saem, e um agente não vê nem escolhe o provedor.

Funciona sem o Obsidian?

Sim. O Obsidian é opcional: as notas são arquivos Markdown que qualquer editor abre, e os agentes usam o cérebro pelo MCP. O Obsidian só é um bom jeito de ler e navegar. Veja Usar com o Obsidian.

Quais clientes de IA funcionam?

Qualquer cliente que fale MCP por stdio. O install-client registra o servidor sozinho no Claude Code, Claude Desktop, Codex, Cursor, VS Code, Antigravity e Gemini CLI. Para outro cliente, cabecao install-client --print mostra a configuração para copiar.

O agente vai encher o cérebro de bobagem?

Ele grava o que as instruções pedem (o durável e não óbvio) e o que você pedir. Tudo vira commit com a sessão marcada, então cabecao undo --list mostra o que entrou e cabecao undo --session <id> tira uma sessão inteira. Regra só entra com o seu pedido explícito, confirmado. Veja O que lembrar.

Posso usar o mesmo cérebro em vários projetos?

Sim. Use scope: project:<nome> no que só vale num projeto. Uma busca ou um recall com escopo de projeto traz o projeto e as notas globais.

E se eu parar de usar o Cabeção?

Nada muda nas suas notas: elas são Markdown num repositório git. Rode cabecao uninstall: ele tira desta máquina os registros nos clientes, as skills, o sync agendado, a configuração e o cache, nunca o cérebro. Depois, se quiser, apague a pasta .cabecao/ do cérebro (banco, índice e travas desta máquina, fora do git). O resto é seu.

Por que "Cabeção"?

É uma homenagem ao Cabeção de Malhação.