nervx: Ferramenta CLI reduz o uso de tokens do Claude Code analisando a estrutura do código-fonte

O que o nervx faz

nervx é uma ferramenta CLI (instalável via pip) que aborda a navegação ineficiente do Claude Code em bases de código. O desenvolvedor a criou após observar que o Claude realizava buscas grep excessivas (60+ vezes para consultas simples) e relia arquivos, consumindo metade da janela de contexto antes de começar o trabalho real.

Como funciona

A ferramenta analisa todo o seu repositório com tree-sitter, constrói um grafo SQLite de cada função, classe, cadeia de chamadas e import, e então gera um arquivo NERVX.md contendo um mapa estrutural do seu projeto. Este mapa inclui pontos de entrada, fluxos de execução, arquivos quentes e código frágil.

A característica principal: executar nervx build . adiciona automaticamente instruções ao seu arquivo CLAUDE.md que ensinam Claude a usar o nervx. O Claude então executa nervx nav por conta própria antes de fazer grep, verifica o raio de impacto antes de refatorar, e geralmente navega de forma mais eficiente sem prompts manuais.

Detalhes técnicos

• Nenhuma configuração de servidor MCP necessária
• Nenhuma chave de API necessária
• Nenhuma chamada LLM durante o processo de build
• Implementação pura tree-sitter + git
• Constrói em menos de 5 segundos
• Custo zero de LLM para a análise

Resultados de desempenho

Testado em um repositório FastAPI com as mesmas 3 perguntas:

• Chamadas de ferramenta: 93 → 56 (-40%)
• Tokens de saída: 15.694 → 8.196 (-48%)
• Buscas grep: 63 → 22 (-65%)

Recursos adicionais

• Identifica código morto
• Sinaliza funções onde os chamadores discordam no tratamento de erros
• Detecta padrões como fábricas e barramentos de eventos a partir da forma do grafo
• Inclui visualização para o grafo gerado
• Suporta Python, JS/TS, Java, Go, Rust, C/C++, C#, Ruby

Por que é diferente

O desenvolvedor evitou especificamente abordagens que usam LLMs para gerar grafos ou exigem configuração MCP, focando em vez disso em análise estática pura para evitar adicionar mais uso de tokens para resolver o problema de desperdício de tokens.