nervx: Herramienta CLI reduce el uso de tokens de Claude Code analizando la estructura del código base

Qué hace nervx

nervx es una herramienta CLI (instalable mediante pip) que aborda la navegación ineficiente de Claude Code en bases de código. El desarrollador la construyó después de observar que Claude realizaba búsquedas grep excesivas (más de 60 veces para consultas simples) y releía archivos, consumiendo la mitad de la ventana de contexto antes de comenzar el trabajo real.

Cómo funciona

La herramienta analiza todo tu repositorio con tree-sitter, construye un grafo SQLite de cada función, clase, cadena de llamadas e importación, luego genera un archivo NERVX.md que contiene un mapa estructural de tu proyecto. Este mapa incluye puntos de entrada, flujos de ejecución, archivos críticos y código frágil.

La característica clave: ejecutar nervx build . automáticamente agrega instrucciones a tu archivo CLAUDE.md que enseñan a Claude cómo usar nervx. Claude luego ejecuta nervx nav por sí mismo antes de hacer grep, verifica el radio de impacto antes de refactorizar, y generalmente navega de manera más eficiente sin indicaciones manuales.

Detalles técnicos

• No se requiere configuración de servidor MCP
• No se necesitan claves API
• Sin llamadas a LLM durante el proceso de construcción
• Implementación pura de tree-sitter + git
• Se construye en menos de 5 segundos
• Costo cero de LLM para el análisis

Resultados de rendimiento

Probado en un repositorio FastAPI con las mismas 3 preguntas:

• Llamadas a herramientas: 93 → 56 (-40%)
• Tokens de salida: 15,694 → 8,196 (-48%)
• Búsquedas grep: 63 → 22 (-65%)

Características adicionales

• Detecta código muerto
• Marca funciones donde los llamadores no concuerdan en el manejo de errores
• Detecta patrones como fábricas y buses de eventos a partir de la forma del grafo
• Incluye visualización para el grafo generado
• Soporta Python, JS/TS, Java, Go, Rust, C/C++, C#, Ruby

Por qué es diferente

El desarrollador evitó específicamente enfoques que usan LLMs para generar grafos o requieren configuración MCP, enfocándose en cambio en análisis estático puro para evitar agregar más uso de tokens al resolver el problema del desperdicio de tokens.