Qu’est-ce que CodeGraph ?
CodeGraph analyse un dépôt en un graphe SQLite local de symboles, appels, imports et héritage, puis le sert aux agents de codage via MCP. Par défaut, le serveur liste un seul outil, codegraph_explore, qui renvoie le code source pertinent groupé par fichier, les chemins d'appel entre symboles et un résumé du rayon d'impact en un appel. Sept outils plus étroits (node, search, callers, callees, impact, files, status) restent disponibles via la variable d'environnement CODEGRAPH_MCP_TOOLS ou comme commandes CLI, et codegraph affected liste les fichiers de test qu'un diff touche.
L'analyse tourne dans un noyau Rust pour 20 langages, avec 34 listés au total, de TypeScript et Python à COBOL, Terraform et Nix, et une détection de routes pour 17 frameworks web. Un surveillant de fichiers met à jour le graphe environ deux secondes après chaque sauvegarde, et aucun LLM ni clé d'API n'est impliqué. codegraph install câble neuf agents, dont Claude Code, Cursor, Codex CLI, Gemini CLI et GitHub Copilot ; codegraph init indexe chaque projet.
Le dépôt, créé en janvier 2026, a environ 75 400 étoiles et est sous licence MIT. La dernière version est v1.6.2 du 3 octobre 2026, et le paquet npm a enregistré environ 77 000 téléchargements dans la semaine jusqu'au 22 octobre. Un produit hébergé d'analyse de pull requests est sur liste d'attente à getcodegraph.com sans prix publié.
Installer CodeGraph
npx @colbymchenry/codegraph && codegraph initCodeGraph vaut-il le coup ?
CodeGraph résout le problème qui mine la plupart des graphes de code : ils se périment. Son surveillant resynchronise les fichiers changés environ deux secondes après une sauvegarde, les réponses d'outils signalent tout fichier encore en attente de synchronisation, et un serveur qui se reconnecte rattrape les éditions faites pendant qu'il était arrêté, comme un git pull. GitNexus a besoin de --watch ou de son palier entreprise pour cela, et Graphify, relu sous repos, est périmé après un pull jusqu'à ce que vous lanciez une mise à jour.
Le benchmark du mainteneur est exceptionnellement soigné pour un auto-rapporté. Claude Opus 4.8 a répondu à une question d'architecture sur chacun de sept dépôts open source, quatre exécutions par bras, avec le CLI codegraph bloqué dans les deux bras après qu'un harnais antérieur a laissé le bras de contrôle l'atteindre dans 26 des 28 exécutions. Les médianes : 88 % d'appels d'outils en moins, 62 % de tokens en moins et 44 % de coût en moins. La dispersion compte plus que la moyenne. Sur VS Code, l'agent a fait 2 appels au lieu de 28 et dépensé 0,53 $ au lieu de 1,80 $ ; sur Gin, un petit projet Go, le coût était égal à 0,31 $. Le README admet aussi l'effet inverse : les réponses denses de CodeGraph laissent environ 80 % de texte récupéré en plus dans la fenêtre de contexte en fin de session, 67 000 tokens contre 18 000 sur VS Code.
La surface étroite est délibérée. Un seul outil listé guide mieux les agents qu'un menu, argumente le mainteneur, et il est en lecture seule, si bien que rien dans le serveur MCP n'édite le code. Cela signifie aussi pas de renommage prévisualisé, pas de requêtes brutes sur le graphe et pas de flux de données au niveau des instructions, tout ce que GitNexus offre. GitNexus lit plus en profondeur ; la licence MIT de CodeGraph laisse une entreprise le faire tourner aujourd'hui, là où GitNexus a besoin d'un accord commercial même pour un pilote.
Deux défauts méritent attention. La télémétrie d'usage anonyme est activée sauf si vous la désactivez dans l'installateur, avec codegraph telemetry off ou avec DO_NOT_TRACK=1 ; les champs documentés excluent le code, les chemins et les requêtes. L'installateur écrit aussi la configuration MCP, les permissions d'auto-autorisation pour Claude Code et une section balisée par des marqueurs dans CLAUDE.md ou AGENTS.md. Les agents ne l'utilisent pas toujours : une issue de juillet rapporte Claude Code faisant quand même du grep, et le correctif est le réglage alwaysLoad désormais dans le README.
Le projet livre vite et a un arriéré à la mesure : environ 140 issues ouvertes et 400 pull requests ouvertes. Le visualiseur codegraph ui apparaît dans la documentation, mais les utilisateurs sur 1.6.0 rapportent « unknown command » dans une issue encore ouverte depuis septembre. Une recherche dans le registre MCP officiel trouve d'autres projets appelés CodeGraph et aucun de ce dépôt, alors vérifiez le nom npm, @colbymchenry/codegraph, avant d'installer.
Là où il fait la différence
Un développeur backend sur un monorepo TypeScript de 11 000 fichiers
Empêcher l'agent de faire du grep sur des dizaines de fichiers avant de pouvoir expliquer un flux
Lancez npx @colbymchenry/codegraph une fois, puis codegraph init dans le dépôt, et réglez alwaysLoad pour que Claude Code voie codegraph_explore dès le premier prompt. Sur le benchmark VS Code du README, cela a réduit une question de 28 appels d'outils à 2 ; budgétez l'empreinte de contexte plus grande dans les longues sessions.
Un ingénieur plateforme dans une entreprise SaaS de 30 développeurs
Ne lancer en CI que les tests qu'un changement peut affecter
Pipez git diff --name-only dans codegraph affected --stdin --quiet et passez le résultat au lanceur de tests. Il suit les imports jusqu'à une profondeur de 5 par défaut, si bien que les tests atteints via injection de dépendances ou réflexion peuvent être manqués ; gardez une exécution complète nocturne.
Un responsable d'ingénierie qui déploie un agent dans une équipe
Donner à chaque développeur le même contexte de code sans négociation de licence
MIT signifie pas d'accord commercial, contrairement à GitNexus. Utilisez codegraph install --yes dans l'image du dev-container et réglez CODEGRAPH_TELEMETRY=0 là si des statistiques d'usage quittant les machines de l'entreprise sont une préoccupation. Le produit PR hébergé est sur liste d'attente uniquement, si bien qu'il n'y a pas de contrat fournisseur à signer ni de prix à comparer.
Avant de vous engager
- Mise en route
- L'installateur shell ou PowerShell embarque son propre runtime, ou npm i -g @colbymchenry/codegraph ; codegraph install configure Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity, Kiro et GitHub Copilot, puis codegraph init construit le graphe de chaque projet. Le README place une indexation fraîche du dépôt du compilateur Swift de 27 000 fichiers à environ 100 secondes.
- Intégrations
- Un outil MCP par défaut (codegraph_explore) sur stdio ; node, search, callers, callees, impact, files et status réactivés avec CODEGRAPH_MCP_TOOLS. Tous sont en lecture seule. Les mêmes fonctions sont des commandes CLI et une API Node (Node 22.5+ en embarqué).
- Données et confidentialité
- Le code, le graphe et les recherches restent locaux dans .codegraph/codegraph.db. La télémétrie envoie des décomptes quotidiens de commandes, d'agents et de langages indexés sauf si désactivée, et le serveur vérifie GitHub pour une nouvelle version une fois par jour. Aucun avis de sécurité n'est publié ; les paquets npm et bundles de version portent des attestations de provenance depuis juillet 2026.
- Coût à grande échelle
- Gratuit ; le coût est le temps machine. Le README rapporte le noyau Linux (70 000 fichiers) s'indexant en moins de 12 minutes sur un VPS à 2 cœurs et 6 Go, et une édition d'un fichier se resynchronisant en environ 4 secondes sur le dépôt Swift. Pas de frais hébergés jusqu'à ce que la plateforme sur liste d'attente se fixe un prix.
- Limites
- Les fichiers de plus de 1 Mo et les chemins gitignorés sont ignorés. L'analyse statique rate le dispatch à l'exécution et la réflexion : la couverture inter-fichiers est de 73,8 % pour Liquid et 83,3 % pour les routes Spring. Les projets WSL2 sur les lecteurs /mnt ont des problèmes de socket et de verrouillage, et un seul écrivain par projet est autorisé.
Les points forts
- Le graphe se resynchronise environ deux secondes après chaque sauvegarde
- Licence MIT ; pas de LLM, clé d'API ni service réseau pour l'indexation
- Surface MCP en lecture seule avec un outil par défaut
- Benchmark auto-rapporté soigné, y compris là où il coûte plus de contexte
Les points faibles
- Télémétrie anonyme activée par défaut
- Pas de renommage, de requêtes brutes ni d'analyse de flux de données, contrairement à GitNexus
- Les réponses laissent plus de texte dans la fenêtre de contexte sur les longues sessions
- Environ 400 pull requests ouvertes ; la commande ui documentée absente des versions
Idéal pour
Les équipes qui veulent que leur agent de codage réponde depuis un graphe de code local toujours à jour sous une licence que leur employeur acceptera.
Alternatives à CodeGraph
CodeGraph : questions fréquentes
- CodeGraph vaut-il le coup ?
- Un graphe de code qui se tient à jour et qu'une entreprise peut adopter sous MIT, bien qu'il lise moins en profondeur que GitNexus et qu'il téléphone à la maison sauf si on le lui interdit. Nous lui donnons 4.1 sur 5.
- Combien coûte CodeGraph ?
- Gratuit et sous licence MIT. Une plateforme hébergée d'analyse de pull requests est en bêta sur liste d'attente à getcodegraph.com ; les prix ne sont pas publiés.
- Quels sont les inconvénients de CodeGraph ?
- Télémétrie anonyme activée par défaut; pas de renommage, de requêtes brutes ni d'analyse de flux de données, contrairement à GitNexus; les réponses laissent plus de texte dans la fenêtre de contexte sur les longues sessions; environ 400 pull requests ouvertes ; la commande ui documentée absente des versions.
- À qui s’adresse CodeGraph ?
- Les équipes qui veulent que leur agent de codage réponde depuis un graphe de code local toujours à jour sous une licence que leur employeur acceptera.
- Combien coûte CodeGraph pour une équipe ou en production ?
- Gratuit ; le coût est le temps machine. Le README rapporte le noyau Linux (70 000 fichiers) s'indexant en moins de 12 minutes sur un VPS à 2 cœurs et 6 Go, et une édition d'un fichier se resynchronisant en environ 4 secondes sur le dépôt Swift. Pas de frais hébergés jusqu'à ce que la plateforme sur liste d'attente se fixe un prix.
- CodeGraph est-il sûr pour les données de l’entreprise ?
- Le code, le graphe et les recherches restent locaux dans .codegraph/codegraph.db. La télémétrie envoie des décomptes quotidiens de commandes, d'agents et de langages indexés sauf si désactivée, et le serveur vérifie GitHub pour une nouvelle version une fois par jour. Aucun avis de sécurité n'est publié ; les paquets npm et bundles de version portent des attestations de provenance depuis juillet 2026.
- Quelles sont les meilleures alternatives à CodeGraph ?
- Les alternatives les plus proches que nous avons testées sont GitNexus, code-review-graph, Serena, Semble et Project RAG.
Réponses vérifiées le 26 oct. 2026.