Madar: Compilador de Contexto Local para Claude Code / Cursor — 78% Menos Tokens en el Repositorio NestJS

Madar es un compilador de contexto local de código abierto para agentes de codificación como Claude Code, Cursor, Copilot y Gemini. Mapea tu repositorio TypeScript/Node.js una vez (localmente, sin dependencias de ML) y sirve un paquete de contexto mínimo vía MCP para cada consulta, evitando el redescubrimiento por defecto del código base que hace el agente en cada sesión.

Cómo funciona

Instala globalmente y genera un gráfico con alcance limitado a tu servicio backend usando --spi (aislamiento de paquete único):

npm i -g @lubab/madar
madar generate . --spi
madar claude install   # o: madar cursor install / madar copilot install

La herramienta es determinista: análisis estático puro de importaciones y rutas de llamada, sin embeddings ni llamadas a modelos.

Benchmark en NestJS + BullMQ (~800 archivos)

Se hizo la misma pregunta ("¿cómo se genera el informe de idea?") a Claude Code con y sin Madar. Números del informe de Anthropic:

• Tokens de entrada: 1.000.776 (sin Madar) → 223.539 (con Madar) — reducción del 78%
• Costo: $1,84 → $0,69 — ahorro del 63%
• Turns: 16 → 5
• Tool calls: 15 → 4

Dónde falla

El autor es transparente sobre las limitaciones:

• Solo se probó en un repositorio, un agente, un tipo de pregunta ("cómo funciona X"). No es una afirmación general.
• El alcance es crítico: usar --spi en un solo servicio funcionó; apuntarlo a todo un monorepo produjo paquetes de contexto que podían aumentar el uso de tokens.
• Las tareas de edición/revisión aún no están validadas; la ventaja es para consultas de tipo explicación.
• Actualmente solo funciona para bases de código TypeScript/Node.js.

Para quién es

Desarrolladores que trabajan en grandes repositorios NestJS, Express o Node.js que dependen de agentes de IA para codificar y quieren reducir el desperdicio de tokens en la recopilación repetitiva de contexto. No es adecuado para monorepos sin un alcance cuidadoso.