¿Qué es CodeGraph?
CodeGraph analiza un repositorio y lo convierte en un grafo SQLite local de símbolos, llamadas, imports y herencia, y lo sirve a los agentes de programación por MCP. Por defecto el servidor ofrece una sola herramienta, codegraph_explore, que en una llamada devuelve el código relevante agrupado por archivo, las rutas de llamada entre símbolos y un resumen del radio de impacto. Siete herramientas más concretas (node, search, callers, callees, impact, files, status) siguen disponibles mediante la variable de entorno CODEGRAPH_MCP_TOOLS o como comandos de la CLI, y codegraph affected lista los archivos de test que toca un diff.
El análisis se hace en un núcleo de Rust para 20 lenguajes, con 34 en total, de TypeScript y Python a COBOL, Terraform y Nix, y detecta rutas en 17 frameworks web. Un vigilante de archivos actualiza el grafo unos dos segundos después de cada guardado, y no interviene ningún LLM ni clave de API. codegraph install configura nueve agentes, entre ellos Claude Code, Cursor, Codex CLI, Gemini CLI y GitHub Copilot; codegraph init indexa cada proyecto.
El repositorio, creado en enero de 2026, tiene unas 75.400 estrellas y licencia MIT. La última versión es la v1.6.2, del 3 de octubre de 2026, y el paquete de npm registró unas 77.000 descargas en la semana hasta el 22 de octubre. Un producto alojado de análisis de pull requests está en lista de espera en getcodegraph.com, sin precios publicados.
Cómo instalar CodeGraph
npx @colbymchenry/codegraph && codegraph init¿Merece la pena CodeGraph?
CodeGraph resuelve el problema que estropea a la mayoría de los grafos de código: se quedan desfasados. Su vigilante resincroniza los archivos modificados unos dos segundos después de guardar, las respuestas de las herramientas señalan cualquier archivo pendiente de sincronizar, y un servidor que se reconecta recupera las ediciones hechas mientras estaba apagado, como un git pull. GitNexus necesita --watch o su plan enterprise para eso, y Graphify, reseñado en repos, queda desfasado tras un pull hasta que ejecutas una actualización.
La prueba del mantenedor es inusualmente cuidadosa para ser autoinformada. Claude Opus 4.8 respondió una pregunta de arquitectura en cada uno de siete repositorios de código abierto, cuatro ejecuciones por grupo, con la CLI de codegraph bloqueada en ambos grupos después de que un arnés anterior dejara al grupo de control llegar a ella en 26 de 28 ejecuciones. Las medianas: un 88% menos de llamadas a herramientas, un 62% menos de tokens y un 44% menos de coste. La dispersión importa más que la media. En VS Code el agente hizo 2 llamadas en lugar de 28 y gastó $0,53 en lugar de $1,80; en Gin, un proyecto pequeño en Go, el coste quedó igual, en $0,31. El README también admite el efecto contrario: las respuestas densas de CodeGraph dejan cerca de un 80% más de texto recuperado en la ventana de contexto al final de una sesión, 67.000 tokens frente a 18.000 en VS Code.
La superficie reducida es deliberada. Una sola herramienta orienta mejor a los agentes que un menú, argumenta el mantenedor, y es de solo lectura, así que nada en el servidor MCP edita código. Eso también significa que no hay vista previa de renombrados, ni consultas directas al grafo, ni flujo de datos a nivel de sentencia, cosas que GitNexus sí ofrece. GitNexus lee con más profundidad; la licencia MIT de CodeGraph permite a una empresa usarlo hoy, mientras que GitNexus exige un acuerdo comercial incluso para un piloto.
Dos valores predeterminados merecen atención. La telemetría anónima de uso está activada salvo que la desactives en el instalador, con codegraph telemetry off o con DO_NOT_TRACK=1; los campos documentados excluyen código, rutas y consultas. El instalador también escribe la configuración MCP, permisos de autorización automática para Claude Code y una sección delimitada con marcadores en CLAUDE.md o AGENTS.md. Los agentes no siempre lo usan: una incidencia de julio informa de que Claude Code sigue usando grep, y la solución es el ajuste alwaysLoad que ahora figura en el README.
El proyecto publica rápido y tiene una cola de trabajo a la altura: unas 140 incidencias abiertas y 400 pull requests abiertos. El visor codegraph ui aparece en la documentación, pero usuarios de la 1.6.0 informan de "unknown command" en una incidencia abierta desde septiembre. Una búsqueda en el registro oficial de MCP encuentra otros proyectos llamados CodeGraph y ninguno de este repositorio, así que comprueba el nombre en npm, @colbymchenry/codegraph, antes de instalar.
Dónde se gana su sitio
Un desarrollador backend en un monorepo de TypeScript de 11.000 archivos
Evitar que el agente haga grep en decenas de archivos antes de poder explicar un flujo
Ejecuta npx @colbymchenry/codegraph una vez, luego codegraph init en el repositorio, y activa alwaysLoad para que Claude Code vea codegraph_explore desde el primer prompt. En la prueba de VS Code del README eso redujo una pregunta de 28 llamadas a herramientas a 2; cuenta con una mayor ocupación de contexto en sesiones largas.
Una ingeniera de plataforma en una empresa SaaS de 30 desarrolladores
Ejecutar en CI solo los tests a los que puede afectar un cambio
Pasa git diff --name-only a codegraph affected --stdin --quiet y entrega el resultado al ejecutor de tests. Sigue los imports hasta una profundidad de 5 por defecto, así que pueden escaparse tests alcanzados mediante inyección de dependencias o reflexión; mantén una ejecución completa nocturna.
Un responsable de ingeniería que despliega un agente en todo un equipo
Dar a cada desarrollador el mismo contexto de código sin negociar una licencia
MIT significa que no hace falta un acuerdo comercial, a diferencia de GitNexus. Usa codegraph install --yes en la imagen del dev container y define ahí CODEGRAPH_TELEMETRY=0 si preocupa que salgan estadísticas de uso de las máquinas de la empresa. El producto alojado para PR solo tiene lista de espera, así que no hay contrato de proveedor que firmar ni precio que comparar.
Antes de decidirte
- Puesta en marcha
- El instalador para shell o PowerShell incluye su propio runtime, o npm i -g @colbymchenry/codegraph; codegraph install configura Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity, Kiro y GitHub Copilot, y después codegraph init construye el grafo de cada proyecto. El README sitúa un índice nuevo del repositorio del compilador de Swift, de 27.000 archivos, en unos 100 segundos.
- Integraciones
- Una herramienta MCP por defecto (codegraph_explore) por stdio; node, search, callers, callees, impact, files y status se reactivan con CODEGRAPH_MCP_TOOLS. Todas son de solo lectura. Las mismas funciones existen como comandos de la CLI y como API de Node (Node 22.5+ si se integra).
- Datos y privacidad
- El código, el grafo y las búsquedas se quedan en local, en .codegraph/codegraph.db. La telemetría envía recuentos diarios de comandos, agentes y lenguajes indexados salvo que se desactive, y el servidor consulta GitHub una vez al día en busca de una versión nueva. No hay avisos de seguridad publicados; los paquetes de npm y los paquetes de cada versión llevan atestaciones de procedencia desde julio de 2026.
- Coste a escala
- Gratis; el coste es tiempo de máquina. El README indica que el kernel de Linux (70.000 archivos) se indexa en menos de 12 minutos en un VPS de 2 núcleos y 6 GB, y que la edición de un archivo se resincroniza en unos 4 segundos en el repositorio de Swift. Sin cuotas de servicio alojado hasta que la plataforma en lista de espera publique precios.
- Límites
- Se omiten los archivos de más de 1 MB y las rutas incluidas en gitignore. El análisis estático no capta el despacho en tiempo de ejecución ni la reflexión: la cobertura entre archivos es del 73,8% en Liquid y del 83,3% en rutas de Spring. Los proyectos de WSL2 en unidades /mnt tienen problemas de sockets y bloqueos, y solo se permite un escritor por proyecto.
Lo bueno
- El grafo se resincroniza unos dos segundos después de cada guardado
- Licencia MIT; sin LLM, clave de API ni servicio de red para indexar
- Superficie MCP de solo lectura con una sola herramienta por defecto
- Prueba autoinformada cuidadosa, que incluye dónde cuesta más contexto
Lo malo
- Telemetría anónima activada por defecto
- Sin renombrado, consultas directas ni análisis de flujo de datos, a diferencia de GitNexus
- Las respuestas dejan más texto en la ventana de contexto en sesiones largas
- Unos 400 pull requests abiertos; el comando ui documentado falta en las versiones publicadas
Ideal para
Equipos que quieren que su agente de programación responda a partir de un grafo de código local siempre al día, con una licencia que su empresa acepte.
Alternativas a CodeGraph
CodeGraph: preguntas frecuentes
- ¿Merece la pena CodeGraph?
- Un grafo de código que se mantiene al día solo y que una empresa puede adoptar bajo MIT, aunque lee con menos profundidad que GitNexus y envía datos a casa salvo que se le diga lo contrario. Le damos un 4.1 sobre 5.
- ¿Cuánto cuesta CodeGraph?
- Gratis y con licencia MIT. Una plataforma alojada de análisis de pull requests está en beta con lista de espera en getcodegraph.com; los precios no están publicados.
- ¿Qué inconvenientes tiene CodeGraph?
- Telemetría anónima activada por defecto; sin renombrado, consultas directas ni análisis de flujo de datos, a diferencia de GitNexus; las respuestas dejan más texto en la ventana de contexto en sesiones largas; unos 400 pull requests abiertos; el comando ui documentado falta en las versiones publicadas.
- ¿Para quién es CodeGraph?
- Equipos que quieren que su agente de programación responda a partir de un grafo de código local siempre al día, con una licencia que su empresa acepte.
- ¿Cuánto cuesta CodeGraph para un equipo o en producción?
- Gratis; el coste es tiempo de máquina. El README indica que el kernel de Linux (70.000 archivos) se indexa en menos de 12 minutos en un VPS de 2 núcleos y 6 GB, y que la edición de un archivo se resincroniza en unos 4 segundos en el repositorio de Swift. Sin cuotas de servicio alojado hasta que la plataforma en lista de espera publique precios.
- ¿Es CodeGraph seguro para los datos de la empresa?
- El código, el grafo y las búsquedas se quedan en local, en .codegraph/codegraph.db. La telemetría envía recuentos diarios de comandos, agentes y lenguajes indexados salvo que se desactive, y el servidor consulta GitHub una vez al día en busca de una versión nueva. No hay avisos de seguridad publicados; los paquetes de npm y los paquetes de cada versión llevan atestaciones de procedencia desde julio de 2026.
- ¿Cuáles son las mejores alternativas a CodeGraph?
- Las alternativas más cercanas que hemos analizado son GitNexus, code-review-graph, Serena, Semble y Project RAG.
Respuestas comprobadas el 26 oct 2026.