Pregúntale a un sistema heredado cómo funciona

Instala la herramienta

Necesitas Python 3.10 o superior. Lo más limpio es instalarlo aislado con uv:

winget install astral-sh.uv                        # Windows
curl -LsSf https://astral.sh/uv/install.sh | sh    # macOS / Linux

uv tool install graphifyy

Si al terminar te dice que no encuentra el comando, falta el PATH:

uv tool update-shell    # y abre una terminal nueva

Regístralo en tu asistente

Graphify se instala como una skill, así que tu asistente aprende a usarla solo:

graphify install

Para dejarlo solo en el proyecto actual en vez de en tu perfil de usuario, agrega --project:

graphify install --project

Construye el grafo

Párate en la carpeta del proyecto y ejecuta:

/graphify .

Al terminar tienes un graph.json, un reporte y una visualización con:

• Nodos centrales — los conceptos por donde pasa todo
• Comunidades — el sistema partido en subsistemas
• Enlaces entre archivos — quién llama, importa o hereda de quién, en unos 40 lenguajes

Pregúntale al sistema

Aquí está lo útil de verdad: consultas en lenguaje natural sobre el grafo.

/graphify query "¿qué conecta la autenticación con la base de datos?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"

Y para mantenerlo vivo mientras el proyecto cambia:

/graphify . --update        # solo reprocesa lo que cambió
graphify hook install       # reconstruye solo en cada commit
/graphify . --wiki          # genera un wiki en markdown

Qué esperar (y qué no)

• El código se analiza local, con tree-sitter. No sale de tu máquina y no necesita API key. Para un proyecto solo de código, agrega --code-only y funciona totalmente sin conexión.
• Los documentos y PDFs sí usan un modelo para extraer significado. Si el cliente tiene requisitos de confidencialidad, se puede forzar todo local con --backend ollama.
• El grafo muestra estructura, no intención: te dice qué llama a qué, no si la decisión de diseño fue buena.
• En proyectos enormes la primera construcción tarda. Después, --update solo procesa lo que cambió.
• Las consultas quedan registradas en ~/.cache/graphify-queries.log. Se desactiva con GRAPHIFY_QUERY_LOG_DISABLE=1.