Claude Code registra cada sessão em disco — Veja como indexá-las e recuperá-las

Claude Code escreve um log JSONL apenas de adição de cada sessão em ~/.claude/projects/ desde o primeiro dia. Cada linha é um objeto JSON estruturado — função, timestamp, conteúdo, chamadas de ferramentas — formando um registro episódico completo que remonta à sua primeira sessão. Um usuário encontrou 1.026 sessões totalizando 57MB e 76.000 turnos, todos no disco sem uma forma integrada de consultá-los.

Construindo uma Camada de Recall

A solução é um indexador open-source (continuity-v2, MIT) que ingere esses logs no SQLite+FTS5 com arestas temporais entre turnos, além de um servidor MCP. De dentro de qualquer sessão do Claude Code, agora você pode executar:

search_sessions("lembra quando corrigimos aquele bug de autenticação no mês passado")
recall_session("a8f2c441")
thread_recall(root_id, depth=8)

A função thread_recall realiza uma travessia BFS pelo grafo de arestas temporais para reconstruir uma thread entre fronteiras de sessão. O indexador também suporta importar conversations.json da exportação de dados do claude.ai, para que o histórico de chat web resida no mesmo índice que as sessões de CLI.

Corrigindo o Hard Reset da Compactação

A compactação é acionada quando o contexto fica cheio, mas o transcript_path no payload PreCompact nem sempre é preenchido no momento do hook. A correção: escrever um checkpoint a cada turno (não apenas no final da sessão) para que PreCompact sempre tenha dados frescos para fallback. Então SessionStart lê o campo source — "compact" significa que a compactação foi acionada, "resume" significa reinicialização do app, "startup" é uma nova sessão, "clear" é intencional. Cada um recebe comportamento diferente. Resultado líquido: a compactação se torna uma falta de cache, não um hard reset.

Discussão & Projetos Semelhantes

Acompanhe a discussão em andamento em anthropics/claude-code#47023. Sete projetos independentes de memória (Bella, NEXO Brain, Cozempic, world-model-mcp, etc.) todos chegaram independentemente aos mesmos requisitos. Uma especificação formal de hook está sendo elaborada lá.

Os hooks levam cerca de cinco minutos para configurar; o servidor MCP é um único arquivo Python. O repositório é licenciado sob MIT.