Graphify : un graphe de connaissances du code pour Claude Code
Graphify transforme un dépôt — code, documentation, schémas SQL, configurations, PDF — en un graphe de connaissances interrogeable depuis Claude Code. Analyse tree-sitter locale, chaque arête étiquetée, pas de base vectorielle.
Graphify en bref
- Un projet open source tiers (Graphify-Labs/graphify, Apache-2.0, écrit en Python), pas un produit Anthropic. Il fournit une skill `/graphify` pour Claude Code, Cursor, Codex, Gemini CLI et d'autres assistants.
- Le code est analysé par tree-sitter en un AST, localement et de façon déterministe, sans appel à un modèle. Chaque arête est étiquetée `EXTRACTED` (explicite dans la source) ou `INFERRED` (résolue par Graphify).
- C'est un graphe que l'on parcourt, pas un index vectoriel : aucun embedding, aucune base vectorielle. `/graphify query` ne renvoie que les nœuds et arêtes nécessaires à la réponse.
- Trois commandes suffisent : `uv tool install graphifyy`, `graphify install`, puis `/graphify .` dans le dépôt. Le résultat arrive dans `graphify-out/`.
Graphify-Labs/graphify — repository and README
Sourcegithub.com2026-11-15
Graphify Quickstart
Sourcedocs.graphify.com2026-11-15
GitHub REST API — repos/Graphify-Labs/graphify
Sourceapi.github.com2026-11-15
Toutes les commandes, options et noms de fichiers de cette page ont été lus dans les trois sources ci-dessus le 2026-11-15. Les commandes et les chemins restent volontairement non traduits : une commande traduite ne s'exécute pas.
Vérifié le 2026-11-15. La branche par défaut est v8 et le dernier push date du 2026-11-14 ; les compteurs d'étoiles et de forks bougent chaque jour, relisez l'API avant de les citer.
Ce qu'est réellement Graphify
La description du projet lui-même : transformer n'importe quelle base de code, avec sa documentation, ses schémas SQL, ses configurations et ses PDF, en un graphe de connaissances interrogeable — une skill `/graphify` pour Claude Code, Cursor, Codex et Gemini CLI, avec une analyse AST locale et déterministe, chaque arête expliquée, et pas de base vectorielle.
En pratique, vous installez un CLI (`graphify`) et une skill, puis vous tapez `/graphify` dans votre assistant. L'assistant exécute la détection, l'extraction et le clustering, écrit le graphe dans `graphify-out/`, puis répond aux questions en parcourant ce graphe au lieu de faire un grep sur l'arborescence.
- Licence
- Apache-2.0
- Langage
- Python (paquet graphifyy)
- Étoiles / forks
- 147,983 / 14,194 — instantané du 2026-11-15
- Statut
- Tiers ; branche par défaut v8 ; dernier push 2026-11-14
Ce n'est pas un projet Anthropic
Graphify est publié par l'organisation Graphify-Labs (l'API GitHub indique is_verified: false) sous Apache-2.0. Anthropic ne le maintient pas et Claude Code ne l'inclut pas : vous l'installez vous-même, et il travaille sur vos propres fichiers.
Comment le graphe est construit
Le code est analysé par tree-sitter en un AST. Cette passe est déterministe et tourne sur votre machine : pas de LLM, rien ne sort. Les liens entre fichiers (calls, imports, inherits, mixes_in) viennent de l'AST, sur une quarantaine de langages ; les commentaires `# NOTE:` / `# WHY:` ainsi que les références ADR et RFC deviennent aussi des nœuds.
Documentation, PDF, images et vidéos passent par une seconde passe, sémantique, qui utilise le modèle de votre assistant ou une clé API configurée. C'est la partie qui coûte des tokens ; la carte du code elle-même n'en coûte pas.
Chaque arête est expliquée
Chaque connexion porte une étiquette : `EXTRACTED` quand la relation est explicite dans la source, `INFERRED` quand Graphify l'a résolue. On voit ce qui a été lu dans le code et ce qui a été déduit.
Pas un index vectoriel
Pas d'embeddings, pas de base vectorielle. Le résultat est un vrai graphe — nœuds, arêtes, communautés, god nodes — que l'on parcourt avec `query`, `path` et `explain`.
Installer Graphify pour Claude Code
Trois commandes. Claude Code est la cible par défaut de `graphify install` ; un autre assistant se choisit avec une option.
Installer le CLI
Le paquet s'appelle `graphifyy` — deux y. Il installe les commandes `graphify` et `graphify-mcp`. Python 3.10 ou plus récent est requis, et n'importe lequel des trois gestionnaires de paquets convient.
# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyyAttention à l'orthographe : on installe `graphifyy`, on tape `graphify` et `graphify-mcp`.
Enregistrer la skill
Sans option, `graphify install` cible Claude Code : la skill est copiée dans `~/.claude/skills/graphify/SKILL.md` et enregistrée dans `~/.claude/CLAUDE.md`. Pour un autre agent, passez `--platform`.
graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codexPar exemple `graphify install --platform codex`. Si `/graphify` n'est toujours pas reconnu, redémarrez l'assistant ou vérifiez que `~/.claude/skills/graphify/SKILL.md` existe.
L'exécuter dans un dépôt
Ouvrez le dépôt dans votre assistant et lancez `/graphify .`. L'agent détecte, extrait et regroupe, puis rend son rapport ; le code est analysé localement, la documentation et les articles passent par le modèle de l'agent.
/graphify .Posez ensuite vos questions : `/graphify query "how does authentication reach the database"` ne renvoie que les nœuds et arêtes utiles, ajustés à un budget de tokens.
Avant de commencer
- 1Python 3.10 ou plus récent.
- 2uv, pipx ou pip — celui que vous utilisez déjà pour vos CLI.
- 3Un assistant de code pris en charge par `graphify install` (Claude Code par défaut), et un dépôt à indexer — local, ou une URL GitHub publique pour `/graphify <url>`.
Les commandes que vous utiliserez vraiment
Reprises telles quelles du quickstart et du tableau de commandes de la documentation. Les commandes commençant par `/` se tapent dans l'assistant ; les autres se lancent dans un shell.
| Commande | Ce qu'elle fait |
|---|---|
/graphify query "…" | Pose une question et ne renvoie que les nœuds et arêtes nécessaires, ajustés à un budget de tokens. |
/graphify path "AuthModule" "Database" | Affiche le plus court chemin entre deux nœuds — ici de AuthModule à Database. |
/graphify explain "SessionStore" | Explique un nœud : ce qu'il est, à quoi il se connecte et pourquoi. |
/graphify . --update | Rafraîchit un graphe existant au lieu de le reconstruire entièrement. |
/graphify . --mode deep | Lance le mode d'extraction plus profond — plus lent, mais davantage de relations sont résolues. |
/graphify . --wiki | Produit en plus une description du graphe façon wiki. |
/graphify https://github.com/<owner>/<repo> | Vise un dépôt public par URL au lieu d'un chemin local. |
graphify hook install | Installe des hooks git (post-commit, post-checkout, post-merge, post-rewrite plus un merge driver) pour que le graphe suive le dépôt ; `graphify hook status` doit alors lister les quatre comme installed. |
graphify god-nodes --top 5 | Affiche les nœuds les plus connectés — un contrôle rapide que le graphe existe et tient debout. |
graphify extract . --code-only | Réextrait uniquement la passe code, en sautant les étapes LLM pour la documentation et les médias. |
graphify uninstall | Supprime la skill et ses enregistrements. |
Si une commande ne trouve pas le graphe, lancez-la depuis le dossier qui contient `graphify-out/`, ou passez `--graph graphify-out/graph.json`.
Ce qui arrive dans graphify-out/
L'arborescence de la documentation, telle quelle :
graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/- 1`graph.json` — le graphe complet, et le fichier à lire quand un autre outil a besoin des données.
- 2`graph.html` — une vue navigateur : cliquer sur les nœuds, filtrer, chercher.
- 3`GRAPH_REPORT.md` — les points saillants, les connexions surprenantes et des questions à poser.
- 4`manifest.json` — le manifeste de ce qui a été indexé.
- 5`cache/` — données de travail locales ; à mettre dans `.gitignore` plutôt qu'à committer.
Que committer
La documentation conseille de committer `graph.json` et `GRAPH_REPORT.md`, et d'ajouter `cache/` au `.gitignore`. La version courte du README annonce « trois fichiers » (`graph.html`, `GRAPH_REPORT.md`, `graph.json`), tandis que le quickstart en liste cinq. Les deux décrivent le même dossier, à des niveaux de détail différents.
Un graphe conservé enregistre aussi `graph.schema_version` et `graph.graphify_version`. Vérifiez-les après une mise à jour du CLI : un graphe ancien peut nécessiter une reconstruction.
Garder le graphe à jour
Un graphe ne vaut que par sa dernière construction, alors branchez-le sur git :
graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registered`graphify hook install` installe les hooks post-commit, post-checkout, post-merge, post-rewrite et un merge driver. `graphify hook status` doit ensuite afficher les quatre hooks installed et « merge driver: registered ».
Quand la documentation ou les images changent, relancez `/graphify . --update` au lieu d'une construction complète.
Quand c'est pertinent, et ce que ça ne fait pas
Graphify est un outil de cartographie du code. Il vaut l'installation quand la forme d'un dépôt compte plus que le texte d'un fichier isolé.
Bon cas d'usage
- 1Vous arrivez dans une base de code inconnue et voulez voir les modules, les god nodes et les communautés avant de lire des fichiers.
- 2La question porte sur une relation — comment ceci atteint cela, qui appelle ceci — et grep y répond mal.
- 3Vous voulez committer la carte pour qu'une équipe ou un agent la relise sans payer une reconstruction.
Limites à connaître
- 1La partie gratuite et entièrement locale couvre le code. Documentation, PDF, images et vidéos passent par un modèle pour la passe sémantique : ces parties coûtent des tokens ou une clé API.
- 2Les arêtes `INFERRED` sont une résolution de Graphify, pas un fait de la source. Lisez l'étiquette avant de faire confiance à une connexion.
- 3Le graphe est un instantané. Sans les hooks ni `--update`, il vieillit comme un README.
- 4C'est un projet tiers jeune : son argumentaire vient de son propre README, pas d'une évaluation indépendante.
Le projet publie son propre tableau de benchmarks dans le README — par exemple un recall@10 LOCOMO de 0,497 à n=300. Ce sont les mesures des mainteneurs, pas un résultat indépendant : traitez-les comme une affirmation à vérifier sur votre propre dépôt.
Graphify sur DeepSeek Harness
Il existe aussi un plugin natif tiers pour DeepSeek Harness, référencé dans son annuaire de plugins. C'est un travail communautaire, distinct du dépôt Graphify-Labs.
Voir la fiche du plugin