CODEGRAPH : un graphe de connaissance local qui booste les agents de code

https://github.com/colbymchenry/codegraph

https://colbymchenry.github.io/codegraph

📌 CODEGRAPH est un outil qui indexe un dépôt de code dans une base SQLite locale et expose le résultat sous forme de graphe de symboles à un agent de développement via un serveur MCP. L’agent interroge le graphe en un seul appel au lieu de parcourir les fichiers un par un, ce qui réduit les tokens, les appels d’outils et le temps de réponse.

Le problème est connu : quand on demande à un agent comment fonctionne une partie du code, il lance des recherches grep, ouvre des fichiers, navigue de fonction en fonction, et consomme des tokens à chaque étape. CODEGRAPH fait ce travail en amont. Il parse le code source avec tree-sitter, extrait les fonctions, classes, méthodes et leurs relations — appels, imports, héritage — et stocke le tout dans SQLite avec un index de recherche plein texte.

• 📊 16 % moins cher et 58 % d’appels d’outils en moins en moyenne
• 🌳 Graphe de symboles extrait par tree-sitter et stocké en SQLite
• 🔍 Recherche plein texte FTS5 dans tout le codebase
• 🔗 Analyse d’impact : appelants, appelés, rayon de blast
• 🔄 Synchronisation automatique via les événements fichier de l’OS
• 🖥️ 100 % local, zéro donnée transmise, zéro clé API

Les benchmarks parlent d’eux-mêmes. Sur sept projets open source réels, de 110 à 10 000 fichiers, un agent avec CODEGRAPH consomme en moyenne 47 % de tokens en moins et répond 22 % plus vite. Sur VS Code (10 000 fichiers), l’agent sans CODEGRAPH effectue 21 appels d’outils et lit 9 fichiers. Avec CODEGRAPH, il fait 4 appels et ne lit aucun fichier — le graphe lui fournit directement le code source pertinent.

L’installation tient en deux commandes. On installe le CLI, on lance codegraph install qui détecte les agents présents sur la machine — Claude Code, Cursor, Codex, OpenCode, Gemini, Kiro — et configure automatiquement le serveur MCP pour chacun. Ensuite, dans chaque projet, codegraph init -i construit l’index initial. Un watcher natif synchronise les modifications en temps réel, sans configuration.

Le graphe couvre plus de vingt langages — TypeScript, Python, Go, Rust, Java, C#, PHP, Ruby, C, C++, Swift, Kotlin, Dart, Lua, entre autres. Il reconnaît les routes de quatorze frameworks web et les relie automatiquement à leurs handlers. Il sait également traverser les frontières entre langages : Swift vers Objective-C, React Native vers du code natif, Expo Modules vers Swift ou Kotlin.

CODEGRAPH s’inscrit dans une logique de pré-calcul plutôt que d’exploration à la demande. Au lieu de laisser l’agent découvrir la structure du code à chaque session, l’outil la compile une fois pour toutes et la tient à jour. L’agent interroge le graphe comme il interrogerait une base de données, et obtient en retour les symboles, leurs relations et leur code source complet.