CodeGraph: ein lokaler Code-Index für Agenten

Alles Wissenswerte über colbymchenry/codegraph: ein lokales Werkzeug, das ein Repository über CLI, Bibliothek und MCP für Coding-Agenten in einen abfragbaren Graphen verwandelt.

---

Was CodeGraph ist

CodeGraph erstellt einen vorindexierten Wissensgraphen eines Repositorys: Symbole, Dateien, Aufrufe, Importe, Vererbung und weitere Beziehungen. Es speichert das Ganze lokal in SQLite mit FTS5-Suche und stellt es dem Agenten über einen MCP-Server bereit, zusätzlich zu einer Kommandozeilenschnittstelle und einer Node.js-API. Laut README und offizieller Dokumentation soll ein Agent so strukturellen Kontext und den Umfang einer Änderung abrufen können, ohne die Architektur über zahlreiche Suchen und Dateizugriffe neu zu rekonstruieren.

Das Tool erklärt Unterstützung für Claude Code, Codex CLI, Cursor, OpenCode, Hermes Agent, Gemini CLI, Antigravity und Kiro. Es erklärt außerdem, dass keine API-Schlüssel nötig sind und der Graph auf dem Rechner bleibt. Das ist eine vom Autor dokumentierte Produkteigenschaft, kein unabhängiges Datenschutzaudit.

Der Ursprung: ein Einzelprojekt aus 2026

Die GitHub-API datiert die Erstellung des Repositorys auf den 18. Januar 2026. Autor und Hauptbeitragender ist Colby Mchenry (colbymchenry); sein GitHub-Profil beschreibt ihn als Profi mit mehr als fünfzehn Jahren Softwareentwicklung. Das npm-Paket erschien laut Veröffentlichungsverlauf am selben Tag.

Die Spannung, die das Projekt aufgreift, ist konkret: Ein Agent, der eine Codebasis verstehen muss, nutzt meist Textsuche und Dateizugriffe, um Aufrufpfade und Abhängigkeiten zu erschließen. CodeGraph schlägt vor, diese Reihenfolge umzukehren: den Index vor der Abfrage aufbauen, ihn synchron halten und dem Agenten eine Reihe relevanter Symbole, Codeausschnitte und Beziehungen zurückgeben. Das README nennt eine wichtige Einschränkung: Die Zahlen zu weniger Tokens und geringeren Kosten messen Verarbeitung und Aufrufe, aber die dichten Antworten können in langen Sitzungen mehr Kontext im Speicher belassen.

Philosophie und Prinzipien

• Lokal zuerst: Die Datenbank .codegraph/codegraph.db und der Index liegen im Projekt; das README erklärt, dass weder Code noch Abfragen an einen externen Dienst gesendet werden.

• Struktureller Kontext statt manueller Erkundung: Eine Abfrage kann Code, Aufrufpfade und den Wirkungsradius liefern, statt den Agenten die Struktur selbst rekonstruieren zu lassen.
• Inkrementelle Aktualisierung: Der MCP-Server beobachtet Betriebssystemänderungen und synchronisiert den Index dateiweise nach einer Wartezeit.

• Ein Einstiegspunkt für den Agenten: Das README belässt codegraph_explore standardmäßig als sichtbares MCP-Tool; die enger gefassten Tools bleiben verfügbar, müssen aber explizit aktiviert werden.

• Überprüfbare Distribution: Seit Juli 2026 dokumentiert das Projekt npm-Provenienz und signierte Attestierungen für die Dateien seiner GitHub-Releases.

Wie es funktioniert

Der dokumentierte technische Ablauf umfasst vier Phasen:

1. Ein nativer Rust-Kern analysiert einen Teil der Sprachen mit Tree-sitter-Grammatiken; portable Pfade und Dateien, die die vorkompilierte Binärdatei nicht nutzen können, greifen auf die alternative Engine zurück.
2. Die Extraktion speichert Knoten und Kanten in .codegraph/codegraph.db, einer SQLite-Datenbank mit FTS5.

3. Der Resolver verbindet Aufrufe mit Definitionen, Importe mit Dateien, Vererbung und Muster von Web-Frameworks; das README listet Routen unter anderem für Django, FastAPI, Express, NestJS, Rails, Spring, Laravel sowie mehrere Go- und Rust-Frameworks.
4. Beim Ausführen des MCP-Servers synchronisiert ein Datei-Watcher Änderungen. Die Dokumentation nennt eine Standardwartezeit von zwei Sekunden, konfigurierbar über CODEGRAPH_WATCH_DEBOUNCE_MS; während dieses Intervalls kann die Antwort darauf hinweisen, dass eine ausstehende Datei direkt gelesen werden muss.

Die Version v1.5.0, veröffentlicht am 21. Juli 2026, brachte den Rust-Kern für zwanzig Sprachen sowie adaptive Anpassungen von Worker-Anzahl und Speicher. Die Release-Notes behaupten eine Synchronisation unter einer Sekunde in Testrepositories, doch das sind projekteigene Messungen.

Offizieller und halboffizieller Status

Es wurde kein Beleg für eine Aufnahme in einen offiziellen Marktplatz von Claude, OpenAI, Cursor oder einem anderen Anbieter gefunden. Die Integration ist halboffiziell im technischen Sinn, nicht kommerziell: codegraph install erkennt Konfigurationen der unterstützten Agenten und trägt den MCP-Server dort ein. Das entspricht keiner Zertifizierung, Empfehlung oder Unterstützung durch diese Anbieter.

Das Paket ist tatsächlich im offiziellen npm-Register als @colbymchenry/codegraph veröffentlicht. Die Dokumentation verlinkt außerdem ein Homebrew-Repository desselben Autors, colbymchenry/homebrew-codegraph, doch es wurde keine offizielle Homebrew-Formel gefunden, und ihre Verfügbarkeit im Hauptkatalog sollte nicht angenommen werden.

Das Ökosystem

Repositories des Autors und verwandte Komponenten

• colbymchenry/homebrew-codegraph (0 Sterne zum Abfragezeitpunkt): ein Repository, das als Homebrew-Repository für CodeGraph beschrieben wird.
• colbymchenry/shopify-graphql-admin-mcp (22 Sterne): ein weiterer MCP-Server des Autors, um Claude mit einem Shopify-Shop zu verbinden. Es handelt sich um ein Schwesterprojekt, keine Abhängigkeit von CodeGraph.
• colbymchenry/frontend-audit-skill (19 Sterne): ein Skill für visuelle Regressionsprüfungen; ebenfalls keine bestätigte Komponente von CodeGraph.
• Das Repository selbst enthält codegraph-kernel, telemetry-dashboard und telemetry-worker. Das sind Verzeichnisse innerhalb des Monorepos, keine eigenständigen öffentlichen Repositories.

Forks, Ports und Erweiterungen

Die Forks-API zeigt Ableger mit expliziten Änderungen, im Gegensatz zu vielen Spiegeln, die die Originalbeschreibung beibehalten:

• Cleboost/codegraph-rs (42 Sterne) beschreibt sich als besonders sparsame Rust-Implementierung.
• ingeniousfrog/CodeDelta (26 Sterne) erklärt, strukturelle Änderungen zu visualisieren und Fehlerursprünge über Commits hinweg zu verfolgen.
• nanofatdog/codegraph_hermes (9 Sterne) behält den lokalen Graphenansatz bei und erwähnt Hermes Agent.
• IppearPeng/codegraphFD (2 Sterne) erklärt, Fortran-Unterstützung hinzuzufügen.
• zybk1003/codegraph (1 Stern) behält eine ins Chinesische übersetzte Beschreibung bei; es handelt sich um einen Community-Fork, keine verifizierte offizielle Übersetzung.

Zudem lieferte die GitHub-Suche Projekte derselben Kategorie, jedoch keine Abhängigkeiten: CodeGraphContext/CodeGraphContext (4.054 Sterne) und Jakedismo/codegraph-rust (860 Sterne). Die Suche stellte keine Zugehörigkeit zu colbymchenry/codegraph fest.

Zahlen zum Repository

Messung: 6. August 2026, GitHub-API und npm-API.

Metrik	Wert
Sterne	64.908
Forks	4.078
Echte Abonnenten	147
Commits	825
Von der API angegebene offene Issues	393
Von GitHub angegebene Hauptsprache	C
Lizenz	MIT
Erstellung	18. Januar 2026
Letzte Metadaten-Aktualisierung	6. August 2026
Letztes Release	v1.5.0, 21. Juli 2026
npm-Downloads, letzte verfügbare 7 Tage	75.949
npm-Downloads, letzte verfügbare 30 Tage	336.711

Die von der API zurückgegebenen Hauptbeitragenden waren colbymchenry (731 Beiträge), github-actions[bot] (26), omonien (16), andreinknv (7) und MO2k4 (4). Die Zahl von 825 Commits stammt von der letzten Seite des Paginierungslinks der API. open_issues_count kann offene Pull-Requests einschließen. Das Feld watchers_count der allgemeinen Antwort dupliziert die Sternezahl; deshalb wird hier subscribers_count als echte Abonnenten angegeben.

Wie man beitragen kann

In den geprüften öffentlichen Pfaden existiert weder eine CONTRIBUTING.md noch eine Pull-Request-Vorlage. Es gibt zwar Tests (__tests__), eine Vitest-Konfiguration und GitHub-Workflows, doch die ausgewerteten Quellen dokumentieren keinen Beitragsprozess, keinen Zielbranch und keine Review-Anforderungen. Es sollte daher kein Prozess unterstellt werden: Vor Beiträgen empfiehlt es sich, ein Issue zu eröffnen oder im Repository nach den aktuellen Kriterien zu fragen.

Wie die Community reagierte

Die abrufbare externe Evidenz ist begrenzt und muss von den Aussagen des Projekts selbst getrennt betrachtet werden:

• Die direkte Hacker-News-Einreichung 49054696, betitelt mit dem Projektnamen und eingereicht von handfuloflight am 26. Juli 2026, hatte 5 Punkte und 0 Kommentare. Das belegt Reichweite, keine Rezension oder Begeisterung der Community.
• Im Thread 48994388 mit 2 Punkten und 1 Kommentar veröffentlichte Nutzer pankaj4u4m, selbsterklärter Maintainer von LemonCrow, einen Vergleich. Er behauptete, CodeGraph habe in seinen 35 Durchläufen die Gesamtkosten um 16,3 % gesenkt, weniger als die von ihm besprochene Token-Reduktion. Zudem behauptete er einen niedrigeren MRR-Wert als bei seinem eigenen Produkt. Der Kommentarautor selbst weist darauf hin, dass dies keine unabhängige Rezension ist, und erklärt, um eine Konfigurationsprüfung gebeten zu haben; es handelt sich also um zugeschriebene Ergebnisse, nicht um einen bestätigten Benchmark.
• Das README veröffentlicht einen eigenen, am 5. August 2026 erneut gemessenen Benchmark über sieben Repositories und behauptet 88 % weniger Aufrufe, 53 % weniger Zeit, 62 % weniger Tokens und 44 % geringere Kosten im Median. Methodik und Repositories sind im README beschrieben, doch es wurde keine externe Nachbildung gefunden; die Werte sind als projekteigene Ergebnisse zu lesen.

Reddit-Suchen in den angefragten Subreddits lieferten wegen des automatisierten Schutzes der Seite keine abrufbaren Inhalte. Anfragen bei X, Product Hunt und YouTube ergaben ebenfalls keinen verifizierbaren Beitrag, keine Launch-Seite und kein verifizierbares Video zu diesem Projekt. DEV Community zeigte lediglich eine Suchseite ohne identifizierbaren Artikel zum Repository. Es wurde weder eine verifizierbare Erwähnung in Newslettern oder Podcasts gefunden noch eine verifizierbare Aufnahme in eine awesome-*-Liste.

CodeGraph im Vergleich zu anderen Ansätzen

Ansatz	Verifizierbare Übereinstimmung	Verifizierbarer Unterschied
CodeGraphContext/CodeGraphContext	MCP-Server und CLI, der lokalen Code in einen Graphen für KI-Assistenten indexiert.	Seine öffentliche Beschreibung spricht von einer Graphdatenbank; CodeGraph dokumentiert SQLite, FTS5 und einen Installer für mehrere Agenten.
Jakedismo/codegraph-rust	Codegraph und Agenten-Tooling über MCP.	Seine Beschreibung erwähnt SurrealDB, AST-Analyse und FastML; kein bestätigter Port von CodeGraph.
optave/ops-codegraph-tool	Lokale CLI für Code-Intelligenz mit MCP und Änderungswirkung.	Erklärt 34 MCP-Tools und Architektur-/CI-Kontrollen, während CodeGraph standardmäßig ein einziges sichtbares MCP-Tool belässt.
LemonCrow	Beide werden als Werkzeuge zur Optimierung von Agentenkontext und -kosten präsentiert.	Der abgerufene Leistungsvergleich stammt vom Maintainer von LemonCrow und stellt keine unabhängige Messung dar.

Kurzanleitung zur Nutzung

Installation und erster Start

Unter macOS oder Linux verweist das README auf diesen eigenständigen Installer; unter Windows bietet es das PowerShell-Äquivalent an:

curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
# In einem neuen Terminal:
codegraph install
cd dein-projekt
codegraph init

Es lässt sich auch über npm installieren:

npm i -g @colbymchenry/codegraph

Der Installer bringt seine eigene Laufzeitumgebung mit, weshalb das README erklärt, dass weder CLI noch MCP Node.js benötigen. codegraph install konfiguriert die erkannten Agenten, indexiert aber kein Projekt; codegraph init erstellt .codegraph/ und baut den Index auf. Nach der Installation muss ein neues Terminal geöffnet werden, damit der Pfad zur ausführbaren Datei verfügbar wird.

Übliche Arbeitsabläufe

• Um den Kontext für eine Aufgabe zu erhalten, codegraph explore "wie gelangt X zu Y" ausführen; das liefert Symbole, Code, Aufrufpfade und eine Zusammenfassung des Wirkungsradius.
• Um eine Änderung vor dem Bearbeiten zu bewerten, codegraph impact <Symbol> verwenden; für potenziell betroffene Tests codegraph affected <Dateien...>.
• Für eine einmalige Abfrage codegraph query <Suche> verwenden; codegraph callers <Symbol> und codegraph callees <Symbol> durchlaufen die direkten Beziehungen.
• Der Index aktualisiert sich beim Arbeiten über MCP automatisch. Ist der Watcher deaktiviert oder läuft die Automatisierung außerhalb einer Agentensitzung, codegraph sync [Pfad] ausführen; codegraph status [Pfad] zeigt den Zustand und ausstehende Dateien an.

Wesentliche Konfiguration

• .codegraph/: projektbezogenes Verzeichnis; enthält den lokalen Index und kann mit codegraph uninit entfernt werden.
• codegraph.json: optionale Datei für exclude, include und includeIgnored; dient dazu, festzulegen, welcher Code in den Index gelangt.
• .gitignore: wird standardmäßig respektiert; eine Negation wie !vendor/ kann einen ausgeschlossenen Pfad wieder einführen, sofern das Tool dies unterstützt.
• CODEGRAPH_WATCH_DEBOUNCE_MS: passt die maximale Wartezeit vor der Synchronisierung von Änderungen an; das README begrenzt sie auf 100 ms bis 60 s.
• CODEGRAPH_MCP_TOOLS: stellt zusätzliche MCP-Tools wieder bereit, zum Beispiel explore,node,search,callers.

Häufige Fallstricke und Lösungen

• Installieren ist nicht gleich Indexieren: Findet der Agent das Projekt nicht, codegraph init von der Wurzel aus ausführen; install verbindet nur Agenten.
• Der Befehl erscheint nicht in derselben Konsole: nach dem Installer ein neues Terminal öffnen.
• Eine veraltete Sperre verhindert das Indexieren: gemäß CLI-Referenz codegraph unlock [Pfad] verwenden.
• Eine frisch bearbeitete Datei ist möglicherweise noch nicht im Graphen: während der Wartezeit direkt lesen oder codegraph status prüfen; für Automatisierung ohne Watcher codegraph sync verwenden.
• Es wird zu viel oder zu wenig indexiert: .gitignore und codegraph.json prüfen. Abhängigkeits-, Build- und Cache-Verzeichnisse sowie Dateien über 1 MB werden standardmäßig ausgeschlossen.

Integrationen und Migration

codegraph install registriert den MCP-Server für die erkannten unterstützten Agenten; die vorgesehene Integration ist MCP, kein editorexklusives Plugin. Zum Rückgängigmachen entfernt codegraph uninstall Konfigurationen und die CLI; codegraph uninstall --keep-cli behält die ausführbare Datei. Projektindizes werden durch diesen Befehl nicht entfernt und separat mit codegraph uninit gelöscht. Die Dokumentation beschreibt keine automatische Migration von CodeGraphContext, LemonCrow oder einem vergleichbaren Werkzeug.

Zur Einbindung als Bibliothek von npm installieren und Node 22.5 oder neuer verwenden; das README bietet CodeGraph.init('/pfad/zum/projekt'), indexAll(), searchNodes(), getCallers() und getImpactRadius().

Anwendungsfälle und wem dieses Repository helfen kann

• Personen, die Agenten in ein bestehendes Repository einbinden, können den Graphen initialisieren und nach einem Pfad, Symbol oder Ablauf fragen, wobei sie Code und Beziehungen erhalten, statt bei dateiweiser Textsuche zu beginnen.
• Teams, die Änderungen mit Ausbreitungsrisiko prüfen, können impact, callers, callees und affected nutzen, um Abhängigkeiten und potenziell betroffene Tests zu untersuchen; die konkrete Abdeckung hängt von den Sprachen, Frameworks und Mustern ab, die die Dokumentation aufführt.
• Polyglotte Repositories oder solche mit einer Web- und einer nativen Schicht können von der mehrsprachigen Extraktion und den vom Projekt erklärten Beziehungen für Framework-Routen, Swift/Objective-C-Brücken und React Native/Expo profitieren. Es lohnt sich, die Abdeckung im eigenen Code zu überprüfen, besonders bei nicht unterstützter Syntax.
• Teams, die die Analyse innerhalb ihrer eigenen Umgebung behalten wollen, können die lokale SQLite-Datenbank und die MCP-Konfiguration ohne API-Schlüssel nutzen, sollten dabei aber die optionale Telemetrie im Blick behalten: Sie lässt sich mit codegraph telemetry off, CODEGRAPH_TELEMETRY=0 oder DO_NOT_TRACK=1 deaktivieren.

Ressourcen

• Repository: https://github.com/colbymchenry/codegraph
• Offizielle Dokumentation: https://colbymchenry.github.io/codegraph/
• Installation und CLI-Referenz: https://github.com/colbymchenry/codegraph#quick-start
• Änderungen und Releases: https://github.com/colbymchenry/codegraph/releases und https://github.com/colbymchenry/codegraph/blob/main/CHANGELOG.md
• npm-Paket: https://www.npmjs.com/package/@colbymchenry/codegraph
• Code des Kerns und Tests: https://github.com/colbymchenry/codegraph/tree/main/codegraph-kernel und https://github.com/colbymchenry/codegraph/tree/main/__tests__
• Diskussionen und Vergleiche: https://news.ycombinator.com/item?id=49054696 und https://news.ycombinator.com/item?id=48994388
• Community/Discord: kein verifizierbarer offizieller Link gefunden.

---

Hinweis: Dieser Artikel kombiniert README, Dokumentation und Releases von CodeGraph, die GitHub-API, das npm-Register sowie die npm-Download-API und Hacker News, abgerufen am 6. August 2026. Zahlen ändern sich mit der Zeit.