README_fr.md

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

Qu'est-ce que GrapeRoot ?

GrapeRoot est un moteur de contexte open-source qui s'intercale entre vous et votre assistant de programmation IA. Il construit un graphe sémantique de votre base de code — fichiers, symboles, imports, chaînes d'appels — et précharge exactement le bon code dans chaque prompt avant que votre IA ne le voie.

Résultat : votre IA dépense ses tokens à raisonner, pas à explorer.

Vous exécutez : dgc /chemin/vers/projet
                    ↓
1. Projet analysé → graphe sémantique construit (fichiers, symboles, imports)
2. Vous posez une question
3. Le graphe identifie les fichiers pertinents → les intègre dans le contexte
4. L'IA reçoit votre question + le bon code déjà chargé
5. Moins de tours, moins de tokens, de meilleures réponses

Les économies de tokens se cumulent tout au long d'une session. Le graphe se souvient des fichiers lus, modifiés et interrogés — chaque tour devient moins coûteux.

Résultats

Évalué sur plusieurs bases de code réelles (plus de 7 700 fichiers) et plus de 50 prompts d'ingénierie :

Réduction des coûts par type de tâche

Les économies se cumulent tout au long d'une session — un token évité au tour 3 évite également la refacturation du cache à chaque tour suivant. La qualité reste égale ou s'améliore pour chaque type de tâche ci-dessus.

Méthodologie complète et résultats des benchmarks : graperoot.dev/benchmarks

Outils IA pris en charge

Langages pris en charge

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

Installation

macOS / Linux :

curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
source ~/.zshrc   # ou ~/.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

Prérequis : Python 3.10+, Node.js 18+, et l'un des outils IA pris en charge. L'installateur détecte les outils manquants et propose de les installer automatiquement.

Utilisation

Important : Utilisez toujours dgc (et non claude directement) pour vous assurer que le serveur MCP est en cours d'exécution.

Claude Code

dgc                                      # analyser le répertoire courant, lancer Claude
dgc /path/to/project                     # analyser un projet spécifique
dgc /path/to/project "fix the login bug" # démarrer avec un prompt

OpenAI Codex CLI

dg                              # analyser le répertoire courant
dg /path/to/project             # analyser un projet spécifique
dg /path/to/project "add tests" # démarrer avec un prompt

Sélecteur interactif (nouveau dans v3.9.99)

graperoot          # affiche la confirmation du répertoire + sélecteur d'outils avec flèches
graperoot .        # idem, à partir du répertoire courant
graperoot --version   # afficher la version actuelle
graperoot --update    # forcer la mise à jour automatique

Tous les outils via 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"   # projet spécifique + prompt

Windows

dgc .                          # depuis l'intérieur du répertoire du projet
dgc "D:\projects\my-app"       # n'importe quel lecteur, n'importe quel chemin
dg "C:\work\backend"           # Codex CLI
dgc --gemini "D:\projects\app" # Gemini CLI sur Windows

Comment ça fonctionne

1. Analyse du graphe — au premier lancement, GrapeRoot extrait les fichiers, fonctions, classes et relations d'import dans un graphe local stocké dans .dual-graph/.
2. Récupération du contexte — à chaque question, le graphe classe les fichiers les plus pertinents et les intègre dans le prompt avant que votre IA ne le voie.
3. Mémoire de session — les fichiers que vous avez lus, modifiés ou interrogés sont pondérés plus fortement dans les tours suivants. Le contexte se cumule.
4. Outils MCP — votre IA peut encore approfondir l'analyse via des outils tenant compte du graphe (graph_read, graph_retrieve, graph_neighbors) lorsqu'elle a besoin d'explorer davantage.

Tout le traitement est local. Aucun code ne quitte votre machine.

Données et fichiers

Toutes les données se trouvent dans <projet>/.dual-graph/ (ajouté automatiquement à .gitignore) :

Installation globale dans ~/.dual-graph/ :

Configuration

Tout est optionnel, via des variables d'environnement :

Mise à jour automatique

Le lanceur vérifie les mises à jour à chaque exécution et se met à jour silencieusement. Pour forcer une mise à jour :

graperoot --update

Pour désactiver la mise à jour automatique :

graperoot --no-auto-update

Pour la réactiver :

graperoot --auto-update

Version actuelle : 3.10.16

Télémétrie

GrapeRoot collecte des rapports de plantage anonymes pour aider à corriger les bugs. Ce qui est envoyé : type d'erreur, quelle étape a échoué, version OS/Python, version de GrapeRoot. Jamais envoyé : votre code, chemins de fichiers, noms de projet, ni données personnelles.

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

GrapeRoot Pro

GrapeRoot Pro ajoute des fonctionnalités avancées pour les utilisateurs expérimentés :

• Mode tâche exhaustif — analyse approfondie multi-fichiers pour les refactorisations complexes
• Détection des exports morts — repérer les exports inutilisés dans toute la base de code
• Détecteur de cycles de dépendances — détecter les chaînes d'imports circulaires
• Recherche inter-bases de code — recherche sémantique sur plusieurs dépôts
• Bouclier d'annulation — hooks pré-utilisation d'outils qui protègent les opérations destructives

Dépannage

« MCP Server Connection Failed »

Utilisez toujours dgc à la place de claude directement. dgc démarre le serveur MCP automatiquement.

# Correction :
claude mcp remove dual-graph
dgc   # réenregistre tout

Guide de dépannage complet

Consultez TROUBLESHOOTING.md ou graperoot.dev/docs.

Contribuer

Les scripts de lancement (bin/) sont open source sous licence Apache 2.0. Les pull requests sont les bienvenues — corrections de bugs, support de nouveaux assistants IA, améliorations de l'installation, documentation.

Remarque : Le moteur de graphe (graperoot pip package) est propriétaire. Les lanceurs et les outils de ce dépôt sont entièrement open source.

Communauté

Vous avez une question, trouvé un bug, ou souhaitez partager des retours ?

Rejoignez le Discord →

Historique des étoiles

Licence

Scripts de lancement et outils de ce dépôt : Apache License 2.0

Le moteur de graphe graperoot (PyPI) : propriétaire. Voir graperoot.dev/graperoot-pro.