Hören Sie auf, neuronale Netze mit Gigabytes an Code zu füttern, und verwandeln Sie Ihr Repository in einen Graphen

Jedes Mal, wenn ich ein unbekanntes Repository mit ein paar zehntausend Zeilen öffne und versuche, KI bei der Refaktorierung einzubinden, passiert dasselbe. Der Assistent beginnt, gierig durch Dateien zu grepen, füllt das Kontextfenster mit unzusammenhängenden Code-Schnipseln, verwirrt sich bei den Aufrufen und produziert am Ende eine Halluzination statt einen funktionierenden Patch. Wir verbrauchen Unmengen an Tokens, doch das Modell versteht nie, wie die Teile des Systems miteinander verbunden sind.

Kürzlich bin ich auf ein interessantes Projekt namens Ix gestoßen. Die Autoren haben beschlossen, das Problem anders anzugehen: Anstatt rohen Text an neuronale Netze zu verfüttern, erstellen sie einen lokalen Abhängigkeitsgraphen aus der Codebase.

Was Ix macht

Im Wesentlichen ist es ein CLI-Tool und lokales Backend, das das Repository mit einem Tree-Sitter-Parser analysiert. Das Tool unterstützt 26 Programmiersprachen, darunter TypeScript, Go, Rust, Python, Java, C++, Ruby und Elixir, und erkennt auch Konfigurationsdateien wie YAML, SQL und Dockerfile.

Während des Scans extrahiert das Tool die Struktur: Funktionen, Klassen, Import-Punkte und Aufrufketten. All das wird in einer lokalen ArangoDB-Graphdatenbank gespeichert, die in Docker läuft. Das Ergebnis ist, dass Entwickler und LLM anstelle endlosen Dateilesens und Rätselratens eine interaktive Karte des Projekts erhalten, die mit gezielten Befehlen abgefragt werden kann.

Der Kontext bleibt zwischen den Sitzungen bestehen. Wenn Sie das Terminal schließen oder den Editor neu starten, verschwinden die angesammelten Verbindungen nicht.

Vier Befehle statt endloser Suche

Die gesamte Arbeit mit dem Tool dreht sich um vier grundlegende Szenarien.

1. Eine Karte erstellen

Zuerst scannen wir die aktuelle Codebase:

ix map .

Der Parser geht durch die Dateien, analysiert Syntaxbäume und baut den initialen Abhängigkeitsgraphen auf.

2. Eine Komponente erklären

Wenn Sie schnell verstehen müssen, wofür ein bestimmtes Modul zuständig ist und womit es verbunden ist, rufen Sie explain auf:

ix explain IngestionService

Der Befehl gibt eine kurze Zusammenfassung für das Symbol aus, zusammen mit einer Liste der eingehenden und ausgehenden Verbindungen.

3. Flows nachverfolgen

Wenn Sie eine Datenverarbeitungskette verfolgen, kommt der trace Befehl zum Einsatz:

ix trace user_login_flow

Er durchläuft die Graphknoten und zeigt die Aufrufsequenz vom Einstiegspunkt bis zum End-Handler.

4. Die Auswirkungen von Änderungen bewerten

Bevor Sie eine geteilte Funktion oder ein Datenschema bearbeiten, lohnt es sich zu prüfen, was möglicherweise beeinträchtigt werden könnte:

ix impact verify_token

Das Tool findet alle Stellen, die direkt oder indirekt vom ausgewählten Symbol abhängen. Laut den Autoren spart diese gezielte Struktursuche zwischen 30 % und 99 % der Tokens bei Entwicklungsaufgaben.

Verbindung zu Editoren über MCP

Die CLI verfügt bereits über einen integrierten Model Context Protocol (MCP)-Server. Das bedeutet, das Tool kann einfach mit jedem modernen KI-Tool verbunden werden: Cursor, VS Code, Claude Code, Codex, Gemini CLI oder OpenClaw.

Die automatische Einrichtung aller erkannter Clients wird mit einem einzigen Befehl gestartet:

ix mcp install

Das Skript prüft die Konfigurationen auf dem Rechner und fügt sorgfältig den ix mcp Server-Start hinzu. Es erstellt auch Sicherungskopien der Konfigurationen mit der Erweiterung .bak und überschreibt keine vorhandenen Einstellungen blind.

Wenn Sie einen Client manuell registrieren müssen (zum Beispiel Codex), führen Sie einfach aus:

codex mcp add ix-memory -- ix mcp

Wenn ein Agent eine Aufgabe abgeschlossen hat, greift er direkt über MCP-Tools auf den lokalen Graphen zu, anstatt blind durch Hunderte von Dateien zu grepen.

Installation und Systemanforderungen

Sie benötigen Node.js 22+, Git, ripgrep und eine funktionierende Docker-Installation mit Docker Compose (darunter läuft ArangoDB).

Unter macOS und Linux ist die Installation ein Einzeiler:

curl -fsSL https://ix-infra.com/install.sh | sh

Für Windows gibt es ein PowerShell-Skript:

irm https://ix-infra.com/install.ps1 | iex

Nach der Installation überprüfen Sie den Servicestatus:

ix status
ix docker start
ix doctor

Wenn die Datenbank noch nicht läuft, startet ix docker start den ArangoDB-Container im Hintergrund.

Fazit

Das Projekt befindet sich derzeit in einer frühen Alpha-Phase, sodass sich das Befehlsverhalten und die API noch ändern können. Die Dokumentation ist derzeit minimal, und die Abhängigkeit von einem lokalen Docker-Container fügt beim ersten Start einigen Overhead hinzu.

Wer sollte das Projekt ausprobieren:

• Entwickler, die häufig durch große, unbekannte Repositories navigieren.
• Diejenigen, die aktiv Claude Code, Cursor oder Codex nutzen und den Kontext-Overflow satt haben.
• Teams, die eine lokale Wissensbasis über Verbindungen innerhalb von Microservices benötigen, ohne Quellcode an Drittanbieter-Server zu senden.

Wenn Sie nach einer Möglichkeit suchen, Ordnung in die Interaktion von KI mit Ihrer Codebase zu bringen, werfen Sie einen Blick auf das GitHub-Repository des Projekts und testen Sie ix map an Ihrem eigenen Projekt.