brain-cli — um CLI de memória local que adiciona memória de longo prazo ao Claude Code

O Claude Code esquece tudo quando a sessão termina.
Você volta a rastrear um bug que pegou há 3 semanas e a rediscutir uma decisão de arquitetura tomada no mês passado.
Também testei o servidor MCP Memory, mas a dependência da nuvem e a qualidade instável da busca eram um problema.

Por isso, implementei memória de longo prazo para agentes usando apenas arquivos Markdown locais em ~/Brain/.

---

Use nestas situações:

① Retomar a sessão de hoje a partir de ontem
brain-cli recall -b -g "bug de login"
→ restaura imediatamente onde você travou ontem e o que já tentou

② Não depurar o mesmo bug duas vezes
Se você registrar sintomas + causa + correção
na próxima sessão, quando encontrar o mesmo erro, o recall mostra primeiro a solução

③ As decisões ficam registradas na memória
O agente para de refazer perguntas como "Por que usar SQLite em vez de Redis?"
O contexto da decisão, as alternativas avaliadas e o motivo da escolha ficam salvos como registros pesquisáveis

④ Várias instâncias do Claude compartilham a mesma memória
O Claude no VS Code e o Claude no terminal leem e escrevem no mesmo Brain
Um bug corrigido de um lado não será corrigido de novo por outra instância

⑤ Automação completa ao integrar com os hooks do CLAUDE.md
Basta adicionar uma linha de recall ao hook SessionStart
e, no início de cada sessão, as memórias relevantes são restauradas automaticamente

---

npm install -g @ernham/brain-cli
Ao instalar, o diretório ~/Brain/ é criado e a rotina de recall é adicionada automaticamente ao CLAUDE.md

GitHub: https://github.com/ernham1/brain-cli | Licença MIT | 87 testes