Codesight CLI reduziert den Token-Verbrauch von KI-Codierungsagenten durch das Scannen von Codebasen.

Was Codesight macht

Codesight ist ein CLI-Tool, das Ihre Codebasis scannt und ein kompaktes Kontextpaket für KI-Assistenten generiert, gespeichert in einem .codesight/-Verzeichnis. Dies verhindert, dass KI-Coding-Agenten wie Claude Code zu Beginn jedes Gesprächs wiederholt dieselben Dateien erkunden, was typischerweise 25K–60K Tokens verbraucht, bevor die eigentliche Arbeit beginnt.

Wie es funktioniert

Führen Sie npx codesight im Stammverzeichnis Ihres Repositorys aus. Das Tool scannt TypeScript- (Next.js, Express, Fastify, Hono, Nest, tRPC, React), Python- (FastAPI, Django, SQLAlchemy) und Go-Stacks (Gin, Gorm) mithilfe von AST/strukturiertem Parsing anstelle von Regex. Es generiert mehrere Dateien:

• CODESIGHT.md – 1–2k Token-Übersicht der Architektur und wichtiger Einstiegspunkte
• routes.md – alle API-Routen mit Methoden, Pfaden und Tags
• schema.md – Datenbankmodelle mit Schlüsselfeldern und Beziehungen
• components.md – UI-Komponenten und Props
• env.md – Umgebungsvariablen mit Verwendungsorten und fehlenden Standardwerten
• graph.md – Importgraph mit „heißen“ Dateien und Auswirkungsanalyse

Die Auswirkungsanalyse durchläuft den Importgraph, um genau anzuzeigen, welche Dateien, Routen und Modelle von einer bestimmten Datei abhängen, und hilft bei Fragen wie „Wenn ich dies ändere, was bricht?“

Integration

Fügen Sie eine Zeile in Ihre CLAUDE.md ein, die Claude anweist, .codesight/CODESIGHT.md und verwandte Dateien zu lesen, bevor er den Baum erkundet. Das Tool wird mit einem MCP-Server und vorgefertigten Profilen für Claude Code, Cursor, Codex und Copilot geliefert, sodass diese Tools .codesight als hochpriorisierten Kontext behandeln.

Benchmarks

Version 1.3.1 Benchmarks aus echten Produktionscodebasen:

• SaveMRR (Hono + Drizzle, 4 Workspaces, 92 Dateien): 5.129 Ausgabe-Tokens vs. 66.040 geschätzte Explorationstokens (12,9-fache Reduktion)
• BuildRadar (raw HTTP + Drizzle, 53 Dateien): 3.945 Ausgabe-Tokens vs. 46.020 geschätzte Explorationstokens (11,7-fache Reduktion)
• Durchschnitt über diese: ≈12,3-fache Token-Reduktion

Bei einem TypeScript/Next-Backend zeigte eine lange „Verstehen + Funktion hinzufügen + Diff überprüfen“-Sitzung, dass 40–50K Explorationstokens vermieden wurden, wenn Claude die Codesight-Dateien liest, anstatt den Baum zu durchsuchen.

Technische Details

Einzelne npx-Binärdatei ohne Laufzeitabhängigkeiten. MIT-Lizenz. Verfügbar auf GitHub unter https://github.com/Houseofmvps/codesight.