Pare de Queimar Tokens: Como um Knowledge Graph Faz seu Agente Entender seu Repo
Há um padrão que você provavelmente já viu seu agente de codificação repetir. Você pergunta onde uma função é usada. Ele faz grep. Lê um arquivo. Faz grep de novo. Abre três arquivos a mais, lê-os de cima a baixo, e depois de doze chamadas de tool você recebe uma resposta — tendo gastado uma pequena fortuna em tokens para reconstruir algo que o “find references” de seu IDE faz instantaneamente.
O problema não é o agente. É que o agente não tem um mapa. A cada sessão, redescobre seu codebase do zero, lendo um arquivo de cada vez.
codebase-memory-mcp, do DeusData, é uma aposta de que isso pode ser consertado. Indexa todo seu repositório em um knowledge graph persistente — funções, classes, call chains, HTTP routes, links entre serviços — e expõe isso ao seu agente através de 14 MCP tools. Em vez de fazer grep e ler, o agente consulta um graph. O repo está em torno de 20.9K estrelas e crescendo rápido, o que diz que a dor de cabeça é bastante compartilhada.
O que faz concretamente
A proposta é velocidade e eficiência. Parseia código com análise de AST via tree-sitter em 158 linguagens, potencializado com resolução semântica de tipos baseada em LSP para os mais pesados (Python, TypeScript/JavaScript, Go, Rust, C/C++, Java, Kotlin, C#, PHP). O resultado é um knowledge graph persistente em SQLite que sobrevive entre sessões — assim seu agente não arranca do zero a cada vez.
A indexação é o destaque. O projeto afirma que indexa completamente um repo médio em milissegundos e todo o kernel do Linux — 28M de linhas, 75K arquivos — em cerca de três minutos, respondendo structural queries em menos de um milissegundo. O pipeline RAM-first (compressão LZ4, SQLite in-memory) libera a memória assim que termina de indexar.
Um watcher thread em background monitora mudanças de arquivos e reindexar apenas o que mudou, assim o graph se mantém atualizado sem um re-parse completo.
O argumento dos tokens
Esta é a parte que vale a pena ler com atenção, porque é a razão de ser da ferramenta. O projeto reporta que cinco structural queries custam em torno de 3.400 tokens através do graph versus uns 412.000 tokens via exploração arquivo por arquivo — o que enquadram como aproximadamente 120x menos tokens. Também há um preprint (arXiv:2603.27277) que descreve benchmarks sobre 31 repos reais, reportando 83% de qualidade de resposta com cerca de 10x menos tokens e 2.1x menos tool calls do que a exploração arquivo por arquivo.
Vale esclarecê-lo: estes são os números do próprio projeto, e o paper do arXiv é um preprint do mesmo time — não uma validação independente. Tome-os como uma afirmação forte para testar em seu próprio repo, não como um fato fechado. Dito isso, o mecanismo faz sentido: uma única query ao graph realmente substitui dezenas de ciclos de grep/read, e isso é algo que você pode verificar você mesmo em uma única sessão.
Instalação e alcance
Esta é a parte que torna fácil realmente testá-lo. Vem como um único binário estático para macOS, Linux e Windows — sem Docker, sem runtime dependencies, sem API keys. Você baixa, roda install, reinicia seu agente, pronto. O instalador autodetecta e configura em 11 agentes de codificação, incluso Claude Code, Codex CLI, Gemini CLI, Zed, OpenCode, Aider e outros — então não é uma jogada exclusiva do Claude Code.
Também há uma visualização 3D do graph integrada (na variante UI) que deixa você explorar o knowledge graph em seu navegador em localhost — útil para realmente ver a forma de um codebase que você herdou.
Vale a pena?
Se você trabalha em repos grandes ou multi-serviço onde seu agente gasta dinheiro real redescubrindo a estrutura a cada sessão, este é um experimento de alto valor com um custo de entrada baixo: um binário, um comando de install. As afirmações de eficiência são auto-relatadas e você deveria verificá-las em seu próprio código — mas a ideia central, dar ao seu agente um mapa persistente em vez de fazê-lo reexplorar a cada vez, é esse tipo de vitória de fazer-mais-com-menos que custa discutir uma vez que você sentiu a fatura de tokens.