Si usas agentes de IA como Claude Code, Cursor o Codex CLI en codebases grandes, sabes que los tokens se consumen rápido. Cada grep, cada lectura de archivo, cada exploración de directorio — todo cuesta. CodeGraph (github.com/colbymchenry/codegraph, 43k+ estrellas) ataca el problema de raíz: en vez de que el agente descubra la estructura del código explorando el filesystem, le entrega un grafo de conocimiento pre-construido.
¿Cómo funciona?
CodeGraph parsea tu codebase con Tree-sitter y construye una base de datos SQLite local que contiene la estructura completa del código: definiciones de funciones, clases, imports, dependencias, relaciones entre archivos. Luego sirve esta información a través del Model Context Protocol (MCP), el estándar abierto para herramientas de agentes.
En lugar de que el agente ejecute una docena de tool calls para responder “¿cómo funciona el sistema de caché?”, le pregunta a CodeGraph directamente, que devuelve los fragmentos relevantes en una sola llamada.
Los números reales (verificados)
CodeGraph publicó benchmarks detallados sobre 7 codebases reales, 7 lenguajes, midiendo 4 rondas por prueba con Claude Opus 4.8. Los promedios verificados:
| Métrica | Mejora |
|---|---|
| Tokens consumidos | 47% menos |
| Tool calls | 58% menos |
| Costo | 16% más barato |
| Tiempo de respuesta | 22% más rápido |
Los ahorros son más dramáticos en codebases grandes:
| Codebase | Lenguaje | Archivos | Reducción de tokens |
|---|---|---|---|
| VS Code | TypeScript | ~10,000 | 64% |
| Django | Python | ~3,000 | 60% |
| OkHttp | Java | ~645 | 54% |
| Alamofire | Swift | ~110 | 64% |
| Tokio | Rust | ~790 | 38% |
| Gin | Go | ~110 | 23% |
| Excalidraw | TypeScript | ~640 | 25% |
La lógica es simple: codebases más grandes tienen más estructura que descubrir, y el agente gasta más tokens en discovery. CodeGraph elimina ese gasto casi por completo.
100% local y sin API keys
CodeGraph es completamente local: la base SQLite vive en tu máquina, ningún dato sale, no necesita API keys externas, no hay servicios en la nube. Soporta más de 20 lenguajes vía Tree-sitter (TypeScript, Python, Go, Rust, Java, C#, PHP, Ruby, C/C++, Swift, Kotlin, Dart, Lua, Svelte, y más).
Tiene un watcher nativo (inotify en Linux, FSEvents en macOS, ReadDirectoryChangesW en Windows) que mantiene el grafo sincronizado automáticamente mientras codeas.
Compatibilidad
CodeGraph funciona como servidor MCP, lo que significa que es compatible con cualquier agente que soporte MCP: Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity IDE y Kiro. La integración es simple: agregas el servidor MCP a la configuración de tu agente y listo.
La advertencia honesta
Los benchmarks de CodeGraph son en preguntas de arquitectura/entendimiento. En tareas de generación de código, fix de bugs o refactoring, los ahorros pueden ser diferentes. También hay que notar que los resultados mejoran con el tamaño del codebase — en proyectos pequeños (<200 archivos), la mejora es modesta y quizás no justifica el setup.
Dicho esto, si trabajas en una codebase mediana o grande y tus facturas de API de Claude/Cursor/Codex te duelen, CodeGraph probablemente te ahorre dinero desde el día uno.