whatisgithub

What is mindwalk?

cosmtrek/mindwalk — explained in plain English

Analysis updated 2026-05-18

889GoAudience · developerComplexity · 2/5Setup · easy

In one sentence

Mindwalk visualizes a coding AI agent's session as glowing light on a 3D map of your codebase, showing which files it searched, read, or edited, with an optional local session evaluation.

Mindmap

mindmap
  root((mindwalk))
    What it does
      Replays agent sessions
      3D repo map visualization
      Local session evaluation
    Tech stack
      Go
      React
      Three.js
    Use cases
      Review agent exploration
      Spot scope creep
      Score session quality
    Audience
      Developers using AI agents
      Team leads reviewing agent work

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Review how thoroughly a Claude Code or Codex session explored a repository before making an edit.

USE CASE 2

Spot whether an AI agent wandered outside the intended scope of a coding task.

USE CASE 3

Ask a local agent CLI to score a session's exploration and verification behavior.

What is it built with?

GoReactThree.js

How does it compare?

cosmtrek/mindwalkoracle/terraform-provider-ocinethical6/conversation-steganography
Stars889865940
LanguageGoGoGo
Last pushed2026-07-15
MaintenanceActive
Setup difficultyeasymoderatemoderate
Complexity2/54/54/5
Audiencedeveloperops devopsresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs fully local via a single Go binary, optional evaluation feature requires a locally installed claude or codex CLI.

No license information is stated in the shown portion of the README.

So what is it?

Mindwalk is a visualization tool that replays a coding AI agent's session as glowing light moving across a 3D map of your codebase. When an AI coding assistant works on a project, it produces a raw log of what it searched, read, and edited, but reading that log line by line does not show whether the agent explored the right parts of the repository or stayed within the scope you intended. Mindwalk turns that log into a night map of your repo where the files the agent actually touched light up, so the shape of its attention becomes something you can see at a glance instead of read. It is a single Go binary that reads session logs from Claude Code and Codex, runs entirely on your own machine, and does not send anything anywhere just from viewing a session. Installing it is a one line curl script, or building from source with make. Running it with no arguments scans your local Claude and Codex session folders, starts a local web server, and opens a browser showing the visualization automatically. Files are colored by how deeply the agent touched them, from unvisited and dark, through seen, read, to edited, and a playback deck lets you scrub through the session over time with search and read actions shown in cool colors and edits shown in warm colors. The tool also includes an optional evaluation feature where it asks your own locally installed claude or codex command line tool to judge how well a session went, covering things like whether the agent explored efficiently, stayed in scope, or wandered. This is the one feature that sends data off your machine, and only when you explicitly trigger it: a summary of the session, including message wording, file paths, and short event descriptions, is sent to the model behind your own account. Reports from these evaluations are cached locally so they are not regenerated automatically. Under the hood, the project separates the session log, the repository layout, and the evaluation report into three distinct pieces, joined by a local Go server that serves a React and Three.js frontend for the 3D view.

Copy-paste prompts

Prompt 1
Walk me through installing mindwalk and running it against my local Claude Code session logs.
Prompt 2
Explain how mindwalk's touch states, seen, read, and edited, are shown on the repository map.
Prompt 3
How do I use mindwalk analyze to evaluate one of my Codex sessions with a local judge model?
Prompt 4
Show me how to open a specific session.jsonl file directly with mindwalk open.

Frequently asked questions

What is mindwalk?

Mindwalk visualizes a coding AI agent's session as glowing light on a 3D map of your codebase, showing which files it searched, read, or edited, with an optional local session evaluation.

What language is mindwalk written in?

Mainly Go. The stack also includes Go, React, Three.js.

What license does mindwalk use?

No license information is stated in the shown portion of the README.

How hard is mindwalk to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mindwalk for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.