[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93226":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":16,"starSnapshotCount":16,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},93226,"mindwalk","cosmtrek\u002Fmindwalk","cosmtrek","A visualization tool that replays coding-agent sessions on a 3D map of your codebase.","",null,"Go",612,35,236,1,0,60,376,78.67,"MIT License",false,"master",true,[],"2026-07-22 04:02:08","# \u003Cimg src=\"assets\u002Flogo.svg\" alt=\"\" width=\"30\" \u002F> mindwalk\n\nA visualization tool that replays coding-agent sessions on a 3D map of your codebase.\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F20ecdc3b-9bc2-469b-ba99-607f3c1d5e0c\n\n*The 30-second demo — sound on.*\n\n## The problem\n\nA session log records what an agent did, but not how it understood the task:\nwhich parts of the repo it treated as relevant, where it explored before it\nacted, whether its footprint matched the scope you had in mind. Reading the\nraw JSONL line by line doesn't answer any of that.\n\n## The idea\n\nDraw the repository as a night map, and play the session back as light moving\nthrough it: where the agent searched, read, and edited, the map glows —\neverything else stays dark. The agent's understanding of the task becomes a\nshape you can see at a glance. One Go binary reads Claude Code and Codex\nsession logs, fully local; no session data leaves your machine.\n\n## Quick start\n\n```sh\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fcosmtrek\u002Fmindwalk\u002Fmaster\u002Fscripts\u002Finstall.sh | sh\nexport PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"\nmindwalk\n```\n\nThe installer verifies the binary against `checksums.txt` and installs to\n`~\u002F.local\u002Fbin` (override with `INSTALL_DIR`; pin a release with `VERSION`).\nWindows archives are on [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fcosmtrek\u002Fmindwalk\u002Freleases).\nTo build from source: `make setup && make build` → `bin\u002Fmindwalk`.\n\nWith no arguments, mindwalk scans `~\u002F.claude\u002Fprojects` and `~\u002F.codex\u002Fsessions`,\nserves the UI on a random local port, and opens a browser:\n\n```text\nmindwalk serve [--port N] [--no-open] [--claude-dir DIR] [--codex-dir DIR]\nmindwalk open [--no-open] \u003Csession.jsonl>   open one specific session\nmindwalk build \u003Crepo> [-o out]              write the repository citymap JSON\nmindwalk trace \u003Csession> [-o out]           write the normalized trace JSON\n```\n\n## Reading the picture\n\n- **Tree \u002F Terrain views** — the repo as a radial tree or a treemap plain;\n  glow ∝ how deeply and how often a file was touched.\n- **Touch states** — each file keeps its deepest touch: seen (moss green),\n  read (moon white), edited (warm amber), unvisited (dark). The HUD folds\n  friction signals — error rate, churned files, edits after the last verify —\n  into a review strip.\n- **Playback deck** — scrub or play the session over a bucketed histogram of\n  the run. Bars sit on a cool\u002Fwarm spectrum: observation stays cool (search,\n  read, exec), mutation glows warm (edit, verify), so editing phases jump out\n  at a glance.\n- **Timeline marks** — `◇` context compactions, `○` subagent launches,\n  `›` user turns; every mark is a click-to-jump target.\n- **Inspector** — click a file to pin its visit history; click a visit row to\n  jump the playhead to that moment.\n\n![the same session on the terrain view](assets\u002Fscreenshot-terrain.png)\n\nKeyboard: `Space` play\u002Fpause · `←`\u002F`→` step (`⇧` ×10) · `Home`\u002F`End` ends ·\n`S` speed · `E` next edit · `X` next error · `M` next mark · `⌘B` session rail.\n\n## Under the hood\n\nTwo artifacts, kept deliberately separate:\n\n1. a **trace** — the session log normalized into an ordered stream of\n   file-touch events (`internal\u002Fadapter`, one adapter per agent format);\n2. a **citymap** — a deterministic layout of the repository\n   (`internal\u002Fcitymap`); the same tree always produces the same map, so\n   replays are comparable across sessions.\n\nA local Go server (`internal\u002Fserver`) joins the two and serves the\nReact\u002FThree.js frontend (`web`). `schema\u002F` mirrors the exported JSON contracts.\n\n## Contributing\n\nIssues and pull requests are welcome. To get a working dev setup:\n\n```sh\nmake setup   # install frontend dependencies\nmake serve   # dev server on :8765, serving web\u002Fdist from the working tree\nmake test    # go test + frontend build — run before sending a PR\nmake build   # regenerate embedded assets and bin\u002Fmindwalk\n```\n\nGround rules (see [AGENTS.md](AGENTS.md) for the full architecture notes):\n\n- Keep the boundaries: adapters don't know about rendering, citymap generation\n  doesn't depend on playback, the server just connects the two.\n- Keep Go code `gofmt`-ed; never hand-edit `internal\u002Fserver\u002Fstatic` —\n  regenerate it with `make build`.\n- When trace or citymap JSON shapes change, update `schema\u002F` and the relevant\n  tests in the same change.\n\n## License\n\n[MIT](LICENSE) © 2026 Ricko Yu\n","mindwalk 是一款本地运行的代码代理会话可视化工具，将编程代理（如Claude Code、Codex）在代码库中的操作轨迹映射为可交互的3D空间图谱。它支持树状\u002F地形视图，以颜色和亮度直观呈现文件被搜索、读取、编辑的深度与频次，并提供时间轴回放、关键事件标记（如上下文压缩、子代理启动）、文件级操作历史追溯等功能。所有处理均在本地完成，会话数据不出设备。适用于代码审查、代理行为审计、开发流程复盘及大型代码库理解等场景。",2,"2026-07-13 02:30:05","CREATED_QUERY"]