CodeGraph: El grafo de conocimiento que reduce en un 92% las llamadas de herramientas en agentes de código

Explorar un codebase con OpenCode, Windsurf o Claude Code puede convertirse muy rápido en una pequeña búsqueda del tesoro: el agente va probando con grep, glob y Read mientras consume tokens en cada paso. Antes de llegar a la parte útil, primero toca encontrar dónde vive cada cosa.

Si alguna vez has pasado 20 minutos preguntándole a un agente "¿dónde está esta función?", ya sabes de qué va el problema. CodeGraph intenta quitarle fricción a ese momento y convertir la conversación en algo mucho más directo: menos arqueología, más respuestas.

Y no es un proyecto que haya pasado desapercibido. En muy poco tiempo ya supera las 7.300 estrellas en GitHub, una señal bastante clara de que el dolor era real.

El problema

Sin una estructura pre-indexada, los agentes de IA pasan la mayor parte del tiempo en descubrimiento:

• find y ls para listar archivos
• grep para buscar patrones
• Read para cargar contenido
• Repetición de llamadas para cada rama de exploración

En codebases grandes (VS Code con 4,000 archivos), un solo Explore agent puede hacer 52 tool calls y tardar 1m 37s en responder una pregunta. Más tiempo buscando, menos tiempo construyendo.

"Un agente sin contexto es como un desarrollador nuevo sin onboarding: va a preguntar por todo."

La solución: CodeGraph

CodeGraph construye un grafo de conocimiento pre-indexado de tu codebase:

• Símbolos: funciones, clases, variables, imports
• Relaciones: call graphs, referencias, herencia
• Estructura: módulos, paquetes, archivos

Los agentes consultan el grafo instantáneamente vía MCP en lugar de escanear archivos. El resultado medio: 92% menos tool calls y 71% más velocidad en exploración. El cambio se nota en la primera petición larga.

Benchmarks reales

Codebase	Con CodeGraph	Sin CodeGraph	Mejora
VS Code (TypeScript)	3 calls, 17s	52 calls, 1m 37s	94% menos · 82% más rápido
Excalidraw (TypeScript)	3 calls, 29s	47 calls, 1m 45s	94% menos · 72% más rápido
Claude Code (Python+Rust)	3 calls, 39s	40 calls, 1m 8s	93% menos · 43% más rápido
Alamofire (Swift)	3 calls, 22s	32 calls, 1m 39s	91% menos · 78% más rápido
Swift Compiler (Swift/C++)	6 calls, 35s	37 calls, 2m 8s	84% menos · 73% más rápido

El benchmark más impresionante: Swift Compiler con 25,874 archivos y 272,898 nodos indexados en menos de 4 minutos. El agent respondió una pregunta compleja cross-cutting con 6 explore calls y cero file reads en 35 segundos.

Instalación en OpenCode

# 1. Ejecutar el instalador interactivo
npx @colbymchenry/codegraph

# 2. El instalador detecta OpenCode automáticamente y configura MCP
# 3. Reiniciar OpenCode
# 4. Inicializar tu proyecto
cd tu-proyecto
codegraph init -i

El instalador es interactivo y auto-detecta los agentes instalados: Claude Code, Cursor, Codex CLI, y OpenCode. Configura el servidor MCP y los archivos de instrucciones automáticamente.

Características clave

• Smart Context Building: un solo tool call retorna entry points, símbolos relacionados y snippets de código — no necesitas agentes de exploración costosos.
• Full-Text Search: busca código por nombre instantáneamente en todo tu codebase, powered por SQLite FTS5.
• Impact Analysis: traza callers, callees y el radio de impacto completo de cualquier símbolo antes de hacer cambios.
• Always-on freshness: un watcher nativo actualiza el grafo sin pedir nada.
• Framework-aware Routes: reconoce archivos de routing en 13 frameworks web y emite nodos route vinculados a sus handlers:
• Django, Flask, FastAPI
• Express
• Laravel, Rails
• Spring
• Gin, chi, gorilla, mux
• Axum, actix, Rocket
• ASP.NET
• Vapor
• React Router, SvelteKit

100% Local

No data sale de tu máquina. No API keys. No servicios externos. Solo SQLite.

Qué opiniones deja

Lo que más repiten quienes lo prueban:

• El agente siente que "ya conoce" la base de código.
• Las preguntas largas ("cómo fluye X") llegan con fragmentos completos a la primera.
• No depende de proveedores externos ni cuotas adicionales.

Cómo funciona bajo el hood

CodeGraph usa MCP (Model Context Protocol) para exponer herramientas a los agentes. Puedes llamarlas manualmente o dejar que el agente las dispare cuando detecta la carpeta .codegraph/:

Herramienta	Propósito
codegraph_search	Buscar símbolos por nombre
codegraph_callers / codegraph_callees	Trazar flujo de llamadas
codegraph_impact	Analizar impacto antes de editar
codegraph_node	Obtener detalles de un símbolo
codegraph_explore	Exploración semántica completa

Un file watcher con eventos nativos del OS (FSEvents/inotify/ReadDirectoryChangesW) mantiene el grafo actualizado mientras codificas — zero config.

Soporte de lenguajes

TypeScript, JavaScript, Python, Go, Rust, Java, C#, PHP, Ruby, C, C++, Swift, Kotlin, Dart, Svelte, Liquid, Pascal/Delphi — 19+ lenguajes y contando.

Qué viene

El roadmap incluye soporte para más lenguajes, integración con más editores y herramientas avanzadas de análisis estático. Ya hay PRs de la comunidad añadiendo nuevos frameworks y lenguajes.

Si trabajas con Claude Code, Cursor, Codex u OpenCode y te toca explicar "cómo se engancha este módulo" todos los días, CodeGraph es una mejora obligatoria: menos tokens, más velocidad y conversaciones que van al grano.