README_es.md

 ▄▀▀▀ █▀▀▄ ▄▀▀▄ █▀▀█ █▀▀▀ █▀▀▄ ▄▀▀▄ ▄▀▀▄ ▀█▀
 █ ▀▄ █▄▄▀ █▄▄█ █▄▄█ █▀▀  █▄▄▀ █  █ █  █  █
 ▀▀▀▀ ▀ ▀▀ ▀  ▀ █    ▀▀▀▀ ▀ ▀▀ ▀▀▀▀ ▀▀▀▀  ▀

¿Qué es GrapeRoot?

GrapeRoot es un motor de contexto de código abierto que actúa como intermediario entre tú y tu asistente de programación con IA. Construye un grafo semántico de tu base de código — archivos, símbolos, importaciones, cadenas de llamadas — y precarga exactamente el código correcto en cada prompt antes de que lo vea tu IA.

El resultado: tu IA dedica los tokens a razonar, no a explorar.

Ejecutas: dgc /path/to/project
              ↓
1. Proyecto escaneado → grafo semántico construido (archivos, símbolos, importaciones)
2. Haces una pregunta
3. El grafo identifica los archivos relevantes → los empaqueta en el contexto
4. La IA recibe tu pregunta + el código correcto ya cargado
5. Menos turnos, menos tokens, mejores respuestas

El ahorro de tokens se acumula a lo largo de una sesión. El grafo recuerda qué archivos fueron leídos, editados y consultados — cada turno se vuelve más económico.

Resultados

Evaluado en múltiples bases de código reales (más de 7,700 archivos) y más de 50 prompts de ingeniería:

Reducción de costo por tipo de tarea

Los ahorros se acumulan a lo largo de una sesión — un token evitado en el turno 3 también evita la refacturación de caché en cada turno posterior. La calidad se mantiene igual o mejora en cada tipo de tarea anterior.

Metodología completa y resultados del benchmark: graperoot.dev/benchmarks

Herramientas de IA Compatibles

Lenguajes Compatibles

TypeScript · JavaScript · Python · Go · Swift · Rust · Java · Kotlin · Scala · C# · Ruby · PHP

Instalación

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
source ~/.zshrc   # o ~/.bashrc / ~/.profile

Windows (PowerShell):

irm https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.ps1 | iex

Windows (Scoop):

scoop bucket add dual-graph https://github.com/kunal12203/scoop-dual-graph
scoop install dual-graph

Requisitos previos: Python 3.10+, Node.js 18+, y una de las herramientas de IA compatibles. El instalador detecta las herramientas faltantes y ofrece instalarlas automáticamente.

Uso

Importante: Usa siempre dgc (no claude directamente) para garantizar que el servidor MCP esté en ejecución.

Claude Code

dgc                                      # escanea el directorio actual, inicia Claude
dgc /path/to/project                     # escanea un proyecto específico
dgc /path/to/project "fix the login bug" # inicia con un prompt

OpenAI Codex CLI

dg                              # escanea el directorio actual
dg /path/to/project             # escanea un proyecto específico
dg /path/to/project "add tests" # inicia con un prompt

Selector Interactivo (nuevo en v3.9.99)

graperoot          # muestra confirmación del directorio + selector de herramientas con flechas
graperoot .        # igual, usa el directorio actual
graperoot --version   # muestra la versión instalada
graperoot --update    # fuerza la actualización automática

Todas las Herramientas vía graperoot

graperoot . --cursor          # Cursor
graperoot . --gemini          # Gemini CLI
graperoot . --opencode        # OpenCode
graperoot . --copilot         # GitHub Copilot
graperoot . --openclaw        # OpenClaw
graperoot . --kilocode        # Kilocode
graperoot . --mimocode        # MiMo Code
graperoot /path --gemini "add tests"   # proyecto específico + prompt

Windows

dgc .                          # desde dentro del directorio del proyecto
dgc "D:\projects\my-app"       # cualquier unidad, cualquier ruta
dg "C:\work\backend"           # Codex CLI
dgc --gemini "D:\projects\app" # Gemini CLI en Windows

Cómo Funciona

1. Escaneo del grafo — en la primera ejecución, GrapeRoot extrae archivos, funciones, clases y relaciones de importación en un grafo local almacenado en .dual-graph/.
2. Recuperación de contexto — cada vez que haces una pregunta, el grafo clasifica los archivos más relevantes y los empaqueta en el prompt antes de que tu IA lo reciba.
3. Memoria de sesión — los archivos que has leído, editado o consultado reciben mayor peso en los turnos futuros. El contexto se acumula.
4. Herramientas MCP — tu IA puede profundizar más mediante herramientas con conocimiento del grafo (graph_read, graph_retrieve, graph_neighbors) cuando necesita explorar.

Todo el procesamiento es local. Ningún código abandona tu máquina.

Datos y Archivos

Todos los datos residen en <project>/.dual-graph/ (añadido automáticamente a .gitignore):

Instalación global en ~/.dual-graph/:

Configuración

Todo es opcional, mediante variables de entorno:

Actualización Automática

El lanzador verifica actualizaciones en cada ejecución y se actualiza silenciosamente. Para forzar una actualización:

graperoot --update

Para desactivar la actualización automática:

graperoot --no-auto-update

Para reactivarla:

graperoot --auto-update

Versión actual: 3.10.16

Telemetría

GrapeRoot recopila informes de fallos anónimos para ayudar a corregir errores. Lo que se envía: tipo de error, qué paso falló, versión de OS/Python, versión de GrapeRoot. Nunca se envía: tu código, rutas de archivos, nombres de proyecto ni datos personales.

graperoot --no-telemetry    # disable
graperoot --telemetry       # re-enable

GrapeRoot Pro

GrapeRoot Pro añade funcionalidades avanzadas para usuarios expertos:

• Modo de tarea exhaustivo — análisis profundo de múltiples archivos para refactorizaciones complejas
• Detección de exportaciones muertas — encuentra exportaciones no utilizadas en toda la base de código
• Detector de ciclos de dependencias — detecta cadenas de importación circulares
• Búsqueda entre bases de código — búsqueda semántica en múltiples repositorios
• Escudo de deshacer — hooks previos al uso de herramientas que protegen operaciones destructivas

Solución de Problemas

"MCP Server Connection Failed"

Usa siempre dgc en lugar de claude directamente. dgc inicia el servidor MCP automáticamente.

# Solución:
claude mcp remove dual-graph
dgc   # vuelve a registrar todo

Guía completa de solución de problemas

Consulta TROUBLESHOOTING.md o graperoot.dev/docs.

Contribuir

Los scripts de lanzamiento (bin/) son de código abierto bajo Apache 2.0. Se aceptan pull requests — correcciones de errores, soporte para nuevos asistentes de IA, mejoras de instalación, documentación.

Nota: El motor de grafos (paquete pip graperoot) es propietario. Los lanzadores y herramientas de este repositorio son completamente de código abierto.

Comunidad

¿Tienes una pregunta, encontraste un error o quieres compartir tus comentarios?

Únete al Discord →

Historial de Estrellas

Licencia

Scripts de lanzamiento y herramientas en este repositorio: Apache License 2.0

El motor de grafos graperoot (PyPI): propietario. Consulta graperoot.dev/graperoot-pro.