Présentation de Graphicle

Graphicle est un outil open‑source écrit en Rust qui crée un code graph à partir d’un dépôt Git et conserve les décisions, la documentation et les sessions précédentes d’agents de programmation. Le projet se positionne comme une alternative locale à Graphify, en éliminant la dépendance aux services cloud : aucune clé d’API, aucun compte et aucune télémétrie ne sont requis.

Architecture et fonctionnement

Lors de l’exécution de graphicle setup, l’outil indexe l’ensemble du dépôt, génère un graphe où chaque nœud représente un fichier ou une fonction, et établit des liens basés sur les importations et les appels. En parallèle, il active la capture de session qui enregistre les requêtes et réponses des agents (Claude Code, Codex, Cursor, etc.). Les informations sont stockées dans un format persistant, ce qui permet aux agents de récupérer des extraits cités lors de nouvelles interrogations. Le système injecte également des hooks Git qui sauvegardent chaque modification et mettent à jour le graphe en temps réel, garantissant la cohérence entre le code source et la mémoire de l’agent.

# Installation rapide via Homebrew
brew install graphicle-ai/tap/graphicle
# Indexation du dépôt et configuration
cd mon-projet
graphicle setup
# Interrogation d'un agent avec contexte graphe
graphicle ask "where is tax added to prices?"

Intégration avec les agents IA

Graphicle redirige les recherches des agents vers le graphe local avant d’appeler le modèle de génération. Ainsi, lorsqu’un développeur demande « where is tax added to prices? », l’agent renvoie des extraits précis du fichier shop/pricing.py, incluant le numéro de ligne et le texte complet de la fonction. Cette approche réduit les hallucinations en contraignant le modèle à des sources vérifiables. Le projet supporte plusieurs clients MCP (Claude Code, Codex, Cursor, VS Code, Claude Desktop) et accepte la configuration du modèle via graphicle config set model anthropic ou openai, offrant une flexibilité d’utilisation selon les licences disponibles.

Limites et perspectives

Actuellement, Graphicle ne propose pas de build natif pour Windows ; l’installation sous WSL2 est la seule alternative, bien que non encore testée de façon exhaustive. Le processus d’indexation peut être coûteux en temps et en mémoire pour de très grands dépôts, car le graphe doit contenir chaque relation de dépendance. De plus, la fiabilité du système dépend de la qualité des hooks Git : toute désactivation accidentelle peut entraîner une désynchronisation entre le graphe et le code réel. Enfin, l’absence de métriques de performance dans le README limite l’évaluation comparative avec d’autres solutions de graphe de code.