Lokaler Code-Index für Codierungsagenten: Löst Importe ohne Sprachserver auf

Basemind ist ein MIT-lizenziertes Rust-Tool, das einen lokalen Code-Index für KI-Coding-Agenten aufbaut, Imports auflöst und einen Call-Graphen ohne Sprachserver erstellt. Es läuft vollständig offline ohne Build-Schritt und ohne sprachspezifischen Daemon, was wichtig ist, wenn das Repo nicht kompiliert, weil ein Agent mitten in der Bearbeitung steckt.

Das Tool stuft die Sprachunterstützung nach Verständnistiefe ein: JS/TS durchläuft oxc für einen echten Scope-Baum, Symboltabelle, Import-/Export-Auflösung und tsconfig-Pfadaliase in Monorepos. Python und Java verwenden GitHub's stack-graphs (archiviert, aber geforkt und gepflegt, mit vier Upstream-Regel-Bugs behoben, die die Auflösung bei typisierten Splat-Parametern oder verketteten Zuweisungen abbrachen). Alles andere erhält nur eine Intra-Datei-lexikalische Scope-Bindung.

371 Grammatiken parsen, etwa 100 geben Symbole und Aufrufe preis, und drei erhalten echte Auflösung. Die wichtigste Designentscheidung: Wenn man nach den Aufrufern einer Funktion fragt, gibt es jede Aufrufstelle zurück, die ein Namensscan findet, mit Anmerkung, welche die Auflösung beweisen konnte, statt nur die bewiesene Teilmenge. Dies vermeidet den Fehlermodus einer früheren Version, die auf bewiesene Treffer filterte und bei einer Datei mit 172 Aufrufern nur 2 meldete, ohne Kürzungsflag.

Leistung: Das Scannen des TypeScript-Compilers (81k Dateien) dauert etwa 18 Sekunden auf einem M4; Git-Verlaufsabfragen landen in zig Mikrosekunden, unabhängig von der Verlaufstiefe. Der Index liegt in einem lokalen Cache.

Der Autor gibt zu, dass dies nicht LSP-Präzision ist; für Generics, Makros, dynamischen Dispatch, DI-Container und Monkey-Patching wird ein Sprachserver richtig liegen, wo Basemind falsch liegt. Aber für Agenten, die mitten in der Bearbeitung eines nicht kompilierenden Repos sind, ist es eine praktische Alternative.

Für wen es ist: Entwickler, die KI-Coding-Agenten bauen oder nutzen, die schnelle, offline Code-Navigation ohne den Overhead von Sprachservern benötigen.