Memtrace: Memória Persistente e Consciente do Tempo para Agentes de Código Claude

Toda sessão longa do Claude Code sofre de contexto desatualizado: o agente relê os mesmos arquivos, esquece detalhes de interfaces e refatora sem entender o raio de impacto. Memtrace é uma camada de memória gratuita e open-source que resolve isso mantendo uma representação do seu código continuamente atualizada e ciente do tempo.

Duas Capacidades Principais

• Estado sempre atualizado: Cada edição aciona um snapshot incremental de 42ms das mudanças aplicadas pelo agente. O agente nunca trabalha com memória de sessões anteriores — após uma refatoração, ele conhece imediatamente todos os chamadores, testes e consumidores da função modificada.
• Retroceder e reproduzir: O código é armazenado bi-temporalmente (valid_time + transaction_time por nó/aresta), permitindo consultas como "como era essa função na segunda-feira" e reproduzindo como uma função quebrada evoluiu commit por commit.

Arquitetura e Apostas de Desempenho

Zero inferência LLM durante a indexação: Tree-sitter analisa o código em uma AST, que se torna a representação estrutural. A recuperação é híbrida — Tantivy BM25 para recall lexical e embeddings Jina-code de 768 dimensões indexados em HNSW para recall semântico, fundidos com Reciprocal Rank Fusion em k=60. Jina-code é treinado em código, então entende "isso é um manipulador de autenticação" sem correspondência de padrões com a palavra "auth".

A camada bi-temporal permite arestas tipadas (CALLS, IMPORTS, IMPLEMENTS, EXTENDS, CONTAINS, TYPE_REFERENCES, INSTANTIATES) percorridas em tempo de grafo, dando ao agente o raio de impacto antes de refatorar. Velocidade é crítica: o gargalo da indexação está em I/O, não em tokens LLM, tornando os snapshots baratos o suficiente para executar a cada edição.

Aprovação e Limites

O binário requer uma chave de aprovação devido a casos extremos de usuários beta reais (lockfiles mistos pnpm/npm, proc-macros Rust, blocos TYPE_CHECKING do Python). Aprovações são limitadas a 50 por semana, com prazo inferior a 24h. O harness de benchmark é totalmente aberto e executável sem a chave. Repositório + lista de espera: github.com/syncable-dev/memtrace-public