Memento Vault: Ferramenta Local para Contexto Persistente em Sessões de Código do Claude

O Memento Vault aborda o problema do Claude Code esquecer o contexto entre sessões, capturando e recuperando automaticamente informações relevantes sem manutenção manual.

Como Funciona

A ferramenta usa hooks que se conectam ao ciclo de vida do Claude Code:

• Quando uma sessão termina: Um hook lê a transcrição, pontua-a e decide o que manter. Sessões substanciais geram notas atômicas gravadas em um repositório git local. Cada nota contém uma ideia com frontmatter incluindo pontuações de certeza e tags, além de wikilinks para notas relacionadas. Sessões triviais recebem uma linha em um registro diário.
• Quando uma sessão inicia: Ele injeta um resumo mostrando suas sessões recentes do projeto e as notas mais relevantes do cofre para o que você está prestes a trabalhar.
• Em cada prompt: Ele pesquisa seu cofre e exibe notas correspondentes antes do Claude processar sua entrada.
• Em cada leitura de arquivo: Ele injeta contexto sobre áreas de código que você tocou anteriormente.

Detalhes Técnicos

Toda a recuperação usa busca local BM25 + vetorial sem chamadas de LLM. O sistema tem latência média de 472ms por prompt e não custa nada para executar. A sobrecarga de contexto é de aproximadamente 149 unidades de entrada por sessão. A qualidade da recuperação pontua NDCG@10 = 0,892 no LongMemEval (500 perguntas).

Uma camada de consolidação em segundo plano chamada Inception agrupa notas por similaridade de embedding e grava notas de padrão após sessões, identificando problemas recorrentes entre projetos.

Todo o sistema usa arquivos markdown em um repositório git, navegável no Obsidian, pesquisável com grep e comparável com git log. Não há banco de dados, Docker ou dependência de nuvem.

Instalação

git clone https://github.com/sandsower/memento-vault.git
cd memento-vault
./install.sh --experimental

Requisitos: Python 3 e Claude Code. QMD adiciona busca semântica (opcional). Funciona no Linux e macOS.

O projeto inclui 271 testes e é licenciado sob MIT.