Mindwalk: Claude-Code/Codex-Sitzungen als Lichtspuren auf einer 3D-Code-Karte wiedergeben

Mindwalk ist ein Visualisierungstool, das Coding-Agent-Sitzungen auf einer 3D-Karte deiner Codebasis abspielt. Anstatt rohe JSONL-Sitzungslogs zu betrachten, erhältst du eine Nachtkarte, auf der sich Licht bewegt, wenn der Agent sucht, liest und bearbeitet – unberührte Teile bleiben dunkel.

Was es löst

Ein Sitzungslog sagt dir, was ein Agent getan hat, aber nicht, wie er die Aufgabe verstanden hat: welche Teile des Repos er als relevant betrachtete, wo er vor dem Handeln erkundete oder ob sein Fußabdruck deiner Absicht entsprach. Zeilenweises Lesen von JSONL beantwortet das nicht.

Schnellstart

curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
mindwalk

Das Installationsprogramm überprüft das Binary anhand von checksums.txt und installiert es nach ~/.local/bin (überschreibbar mit INSTALL_DIR; eine bestimmte Version mit VERSION festlegen). Windows-Archive sind auf GitHub Releases. Um aus dem Quellcode zu bauen: make setup && make build → bin/mindwalk.

Befehle

Ohne Argumente scannt mindwalk ~/.claude/projects und ~/.codex/sessions, stellt die UI auf einem zufälligen lokalen Port bereit und öffnet einen Browser:

• mindwalk serve [--port N] [--no-open] [--claude-dir VERZ] [--codex-dir VERZ]
• mindwalk open [--no-open] <session.jsonl> — öffne eine bestimmte Sitzung
• mindwalk build <repo> [-o aus] — schreibe das Repository-Citymap-JSON
• mindwalk trace <session> [-o aus] — schreibe das normalisierte Trace-JSON

Die Visualisierung lesen

• Baum-/Geländeansichten — das Repo als radialer Baum oder Treemap; Leuchtintensität ∝ wie tief und oft eine Datei berührt wurde.
• Berührungszustände — jede Datei behält ihre tiefste Berührung: gesehen (Moosgrün), gelesen (Mondweiß), bearbeitet (Warmbernstein), unbesucht (dunkel).
• HUD faltet Reibungssignale — Fehlerrate, umgewälzte Dateien, Bearbeitungen nach der letzten Verifikation — in einen Überprüfungsstreifen.
• Wiedergabe-Deck — über ein gebündeltes Histogramm scrubben oder abspielen. Balken auf einem kalt/warm-Spektrum: Beobachtung (Suche, Lesen, Ausführen) bleibt kalt, Mutation (Bearbeiten, Verifizieren) glüht warm.
• Zeitachsen-Markierungen — ◇ Kontextkomprimierung, ○ Subagentenstarts, › Benutzereingriffe; klicken, um zu springen.
• Inspektor — klicke eine Datei an, um ihre Besuchshistorie anzuheften; klicke eine Besuchszeile, um den Abspielkopf zu setzen.
• Tastatur: Leertaste Abspielen/Pause · ←/→ Schritt (⇧×10) · Pos1/Ende Enden · S Geschwindigkeit · E nächste Bearbeitung · X nächster Fehler · M nächste Markierung · ⌘B Sitzungsleiste.

Unter der Haube

Zwei separate Artefakte: ein Trace (normalisierter Strom von Dateiberührungsereignissen aus Sitzungslogs über Adapter in internal/adapter) und eine Citymap (deterministisches Layout des Repositorys in internal/citymap). Ein lokaler Go-Server (internal/server) verbindet sie und bedient das React/Three.js-Frontend (web). Schema-Verträge leben in schema/.

Derselbe Baum erzeugt immer dieselbe Karte, sodass Wiedergaben über Sitzungen hinweg vergleichbar sind. Keine Sitzungsdaten verlassen deinen Rechner – vollständig lokal.