Codesight CLI réduit l'utilisation de jetons des agents de codage IA en analysant les bases de code.

Ce que fait Codesight

Codesight est un outil CLI qui analyse votre codebase et génère un pack de contexte compact pour les assistants IA, stocké dans un répertoire .codesight/. Cela empêche les agents de codage IA comme Claude Code d'explorer à plusieurs reprises les mêmes fichiers au début de chaque conversation, ce qui consomme généralement 25K–60K tokens avant que le travail réel ne commence.

Comment cela fonctionne

Exécutez npx codesight à la racine de votre dépôt. L'outil analyse les piles TypeScript (Next.js, Express, Fastify, Hono, Nest, tRPC, React), Python (FastAPI, Django, SQLAlchemy) et Go (Gin, Gorm) en utilisant l'analyse AST/structurée au lieu des expressions régulières. Il génère plusieurs fichiers :

• CODESIGHT.md – aperçu de 1–2k tokens de l'architecture et des points d'entrée clés
• routes.md – toutes les routes API avec méthodes, chemins et étiquettes
• schema.md – modèles de base de données avec champs clés et relations
• components.md – composants d'interface utilisateur et leurs propriétés
• env.md – variables d'environnement avec emplacements d'utilisation et valeurs par défaut manquantes
• graph.md – graphe d'importation avec fichiers "chauds" et analyse du rayon d'impact

L'analyse du rayon d'impact parcourt le graphe d'importation pour montrer exactement quels fichiers, routes et modèles dépendent d'un fichier donné, aidant à répondre aux questions "si je change ceci, qu'est-ce qui casse ?".

Intégration

Ajoutez une ligne à votre CLAUDE.md indiquant à Claude de lire .codesight/CODESIGHT.md et les fichiers associés avant d'explorer l'arborescence. L'outil est livré avec un serveur MCP et des profils prêts à l'emploi pour Claude Code, Cursor, Codex et Copilot, afin que ces outils traitent .codesight comme un contexte haute priorité.

Benchmarks

Benchmarks de la version 1.3.1 à partir de codebases de production réelles :

• SaveMRR (Hono + Drizzle, 4 espaces de travail, 92 fichiers) : 5 129 tokens de sortie contre 66 040 tokens d'exploration estimés (réduction de 12,9×)
• BuildRadar (HTTP brut + Drizzle, 53 fichiers) : 3 945 tokens de sortie contre 46 020 tokens d'exploration estimés (réduction de 11,7×)
• Moyenne sur ces exemples : ≈ réduction de 12,3× des tokens

Sur un backend TypeScript/Next, une longue session "comprendre + ajouter une fonctionnalité + examiner les différences" a montré 40–50K tokens d'exploration évités lorsque Claude lit les fichiers Codesight au lieu de parcourir l'arborescence.

Détails techniques

Binaire unique npx sans dépendances d'exécution. Licence MIT. Disponible sur GitHub à https://github.com/Houseofmvps/codesight.