Graphify: un grafo de conocimiento del código para Claude Code
Graphify convierte un repositorio —código, documentación, esquemas SQL, configuraciones y PDF— en un grafo de conocimiento consultable desde Claude Code. Análisis local con tree-sitter, cada arista etiquetada, sin almacén vectorial.
Graphify de un vistazo
- Un proyecto de código abierto de terceros (Graphify-Labs/graphify, Apache-2.0, escrito en Python), no un producto de Anthropic. Ofrece una skill `/graphify` para Claude Code, Cursor, Codex, Gemini CLI y otros asistentes.
- El código se analiza con tree-sitter hasta un AST, de forma local y determinista, sin llamar a ningún modelo. Cada arista se etiqueta como `EXTRACTED` (explícita en la fuente) o `INFERRED` (resuelta por Graphify).
- Es un grafo que se recorre, no un índice vectorial: sin embeddings ni almacén vectorial. `/graphify query` devuelve solo los nodos y aristas que necesita la respuesta.
- Tres comandos bastan: `uv tool install graphifyy`, `graphify install` y `/graphify .` dentro del repositorio. La salida aparece en `graphify-out/`.
Graphify-Labs/graphify — repository and README
Fuentegithub.com2026-11-15
Graphify Quickstart
Fuentedocs.graphify.com2026-11-15
GitHub REST API — repos/Graphify-Labs/graphify
Fuenteapi.github.com2026-11-15
Todos los comandos, opciones y nombres de archivo de esta página se leyeron de las tres fuentes anteriores el 2026-11-15. Los comandos y las rutas se dejan sin traducir a propósito: un comando traducido no se ejecuta.
Verificado el 2026-11-15. La rama por defecto es v8 y el último push fue el 2026-11-14; los recuentos de estrellas y forks cambian a diario, así que vuelve a leer la API antes de citarlos.
Qué es Graphify en realidad
La descripción del propio proyecto: convertir cualquier base de código, junto con su documentación, esquemas SQL, configuraciones y PDF, en un grafo de conocimiento consultable —una skill `/graphify` para Claude Code, Cursor, Codex y Gemini CLI, con análisis AST local y determinista, cada arista explicada y sin almacén vectorial.
En la práctica instalas una CLI (`graphify`) y una skill, y luego escribes `/graphify` dentro de tu asistente. El asistente ejecuta detección, extracción y agrupación, escribe el grafo en `graphify-out/` y después responde recorriendo ese grafo en lugar de hacer grep sobre el árbol.
- Licencia
- Apache-2.0
- Lenguaje
- Python (paquete graphifyy)
- Estrellas / forks
- 147,983 / 14,194 — instantánea del 2026-11-15
- Estado
- Terceros; rama por defecto v8; último push 2026-11-14
No es un proyecto de Anthropic
Graphify lo publica la organización Graphify-Labs (la API de GitHub informa is_verified: false) bajo Apache-2.0. Anthropic no lo mantiene y Claude Code no lo incluye: lo instalas tú y trabaja sobre tus propios archivos.
Cómo se construye el grafo
El código se analiza con tree-sitter hasta un AST. Esa pasada es determinista y se ejecuta en tu máquina: sin LLM y sin que nada salga de ella. Los enlaces entre archivos (calls, imports, inherits, mixes_in) salen del AST en unas 40 lenguajes, y los comentarios `# NOTE:` / `# WHY:` junto con las referencias a ADR y RFC también se convierten en nodos.
La documentación, los PDF, las imágenes y el vídeo pasan por una segunda pasada semántica que usa el modelo de tu asistente o una clave de API configurada. Esa es la parte que consume tokens; el mapa del código no.
Cada arista está explicada
Cada conexión lleva una etiqueta: `EXTRACTED` cuando la relación es explícita en la fuente, `INFERRED` cuando la resolvió Graphify. Así distingues lo leído del código de lo deducido.
No es un índice vectorial
No hay embeddings ni almacén vectorial. La salida es un grafo real —nodos, aristas, comunidades, god nodes— que recorres con `query`, `path` y `explain`.
Instalar Graphify para Claude Code
Tres comandos. Claude Code es el destino por defecto de `graphify install`; otro asistente está a una opción de distancia.
Instala la CLI
El paquete es `graphifyy`, con dos y. Instala los comandos `graphify` y `graphify-mcp`. Requiere Python 3.10 o superior y sirve cualquiera de los tres gestores de paquetes.
# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyyCuidado con la ortografía: se instala `graphifyy`, pero se escriben `graphify` y `graphify-mcp`.
Registra la skill
Sin opciones, `graphify install` apunta a Claude Code: copia la skill en `~/.claude/skills/graphify/SKILL.md` y la registra en `~/.claude/CLAUDE.md`. Para otro agente, pasa `--platform`.
graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codexPor ejemplo `graphify install --platform codex`. Si `/graphify` sigue sin reconocerse, reinicia el asistente o comprueba que exista `~/.claude/skills/graphify/SKILL.md`.
Ejecútalo en un repositorio
Abre el repositorio en tu asistente y ejecuta `/graphify .`. El agente detecta, extrae y agrupa, y luego informa; el código se analiza localmente y la documentación y los artículos pasan por el modelo del propio agente.
/graphify .Después pregunta: `/graphify query "how does authentication reach the database"` devuelve solo los nodos y aristas necesarios, recortados a un presupuesto de tokens.
Antes de empezar
- 1Python 3.10 o superior.
- 2uv, pipx o pip: el que ya uses para tus CLI.
- 3Un asistente de código compatible con `graphify install` (Claude Code por defecto) y un repositorio que indexar: local, o una URL pública de GitHub para `/graphify <url>`.
Los comandos que sí vas a usar
Copiados tal cual del quickstart y de la tabla de comandos de la documentación. Los que empiezan por `/` se escriben en el asistente; el resto se ejecuta en una shell.
| Comando | Qué hace |
|---|---|
/graphify query "…" | Hace una pregunta y devuelve solo los nodos y aristas necesarios, recortados a un presupuesto de tokens. |
/graphify path "AuthModule" "Database" | Muestra el camino más corto entre dos nodos, aquí de AuthModule a Database. |
/graphify explain "SessionStore" | Explica un nodo: qué es, con qué se conecta y por qué. |
/graphify . --update | Actualiza un grafo existente en lugar de reconstruirlo desde cero. |
/graphify . --mode deep | Ejecuta el modo de extracción más profundo: más lento, pero resuelve más relaciones. |
/graphify . --wiki | Genera además una descripción del grafo al estilo wiki. |
/graphify https://github.com/<owner>/<repo> | Apunta a un repositorio público por URL en vez de a una ruta local. |
graphify hook install | Instala hooks de git (post-commit, post-checkout, post-merge, post-rewrite y un merge driver) para que el grafo siga al repositorio; `graphify hook status` debería listar los cuatro como installed. |
graphify god-nodes --top 5 | Imprime los nodos más conectados: una comprobación rápida de que el grafo existe y tiene sentido. |
graphify extract . --code-only | Vuelve a extraer solo con la pasada de código, saltando los pasos de LLM para documentación y multimedia. |
graphify uninstall | Elimina la skill y sus registros. |
Si un comando no encuentra el grafo, ejecútalo desde el directorio que contiene `graphify-out/` o pasa `--graph graphify-out/graph.json`.
Qué aparece en graphify-out/
El árbol de la documentación, tal cual:
graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/- 1`graph.json`: el grafo completo, y el archivo que leen otras herramientas.
- 2`graph.html`: vista en el navegador, con clic en nodos, filtros y búsqueda.
- 3`GRAPH_REPORT.md`: los puntos clave, las conexiones inesperadas y preguntas sugeridas.
- 4`manifest.json`: el manifiesto de lo que se indexó.
- 5`cache/`: datos de trabajo locales; añádelo a `.gitignore` en lugar de confirmarlo.
Qué confirmar en git
La documentación sugiere confirmar `graph.json` y `GRAPH_REPORT.md`, y añadir `cache/` a `.gitignore`. La versión corta del README habla de «tres archivos» (`graph.html`, `GRAPH_REPORT.md`, `graph.json`), mientras que el quickstart enumera cinco entradas. Ambas describen el mismo directorio con distinto nivel de detalle.
Un grafo guardado también registra `graph.schema_version` y `graph.graphify_version`. Revísalos tras actualizar la CLI: un grafo antiguo puede necesitar reconstrucción.
Mantener el grafo al día
Un grafo vale lo que vale su última compilación, así que engánchalo a git:
graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registered`graphify hook install` conecta los hooks post-commit, post-checkout, post-merge y post-rewrite más un merge driver. Después, `graphify hook status` debería mostrar los cuatro como installed y «merge driver: registered».
Cuando cambien la documentación o las imágenes, vuelve a ejecutar `/graphify . --update` en lugar de una compilación completa.
Cuándo encaja y qué no hace
Graphify es una herramienta de mapas de código. Merece la instalación cuando la forma de un repositorio importa más que el texto de un archivo concreto.
Encaja bien
- 1Entras a una base de código desconocida y quieres ver los módulos, los god nodes y las comunidades antes de leer archivos.
- 2La pregunta es de relación —cómo llega esto a aquello, quién llama a esto— y grep responde mal a eso.
- 3Quieres confirmar el mapa para que un equipo o un agente lo relea sin pagar una reconstrucción.
Límites que conviene saber
- 1La parte gratuita y totalmente local cubre el código. La documentación, los PDF, las imágenes y el vídeo pasan por un modelo en la pasada semántica, así que esas partes cuestan tokens o una clave de API.
- 2Las aristas `INFERRED` son una resolución de Graphify, no un hecho de la fuente. Lee la etiqueta antes de fiarte de una conexión.
- 3El grafo es una instantánea. Sin los hooks ni `--update` se queda obsoleto igual que un README.
- 4Es un proyecto de terceros joven: su argumento viene de su propio README, no de una evaluación independiente.
El proyecto publica su propia tabla de benchmarks en el README, por ejemplo un recall@10 de LOCOMO de 0,497 con n=300. Son mediciones de los mantenedores, no un resultado independiente: trátalas como una afirmación que conviene verificar en tu propio repositorio.
Graphify en DeepSeek Harness
También hay un plugin nativo de terceros para DeepSeek Harness, listado en su directorio de plugins. Es trabajo de la comunidad, independiente del repositorio de Graphify-Labs.
Ver la ficha del plugin