mindwalk is a command‑line Go binary that visualizes Claude Code and Codex agent sessions on a 3‑D map of a repository. It parses raw JSONL logs locally, builds a deterministic *citymap* layout, and serves a React/Three.js front‑end that renders the map as a night sky. The agent’s activity lights up the map: files seen turn *moss green*, read files become *moon white*, edits glow *warm amber*, and unvisited files stay dark.

The tool separates concerns into three artifacts: a *trace* that normalizes agent events, a *citymap* that deterministically positions files, and a lightweight Go server that joins them. Developers can install via a one‑liner that verifies checksums, or build from source with `make setup && make build`. The UI offers a HUD with friction signals, a playback deck that shows a bucketed histogram of actions, and a timeline with clickable markers for context compactions, sub‑agent launches, and user turns.

mindwalk keeps all data on‑device; no session data leaves the machine. The binary serves a local port, automatically opens a browser, and supports command‑line flags to specify agent directories or open a single session file. Contributions are encouraged, with clear ground rules that keep adapters, city‑map generation, and rendering separate.

By turning logs into a visual map, mindwalk lets engineers spot where agents spent time, how they traversed code, and whether their edits align with intended scopes. The simple installation and local execution make it a practical addition to any agent‑driven workflow.