Mindwalk: Воспроизведение сессий Claude Code/Codex в виде световых следов на 3D карте кода

Mindwalk — это инструмент визуализации, который воспроизводит сессии агентов кодинга на 3D-карте вашей кодовой базы. Вместо того чтобы вглядываться в сырые JSONL-логи сессий, вы получаете ночную карту, где свет движется по мере того, как агент ищет, читает и редактирует — нетронутые части остаются темными.

Какую проблему решает

Лог сессии говорит вам, что сделал агент, но не показывает, как он понял задачу: какие части репозитория он счел релевантными, где он исследовал перед действием или соответствует ли его след вашему замыслу. Построчное чтение JSONL на это не отвечает.

Быстрый старт

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

Установщик проверяет бинар по контрольной сумме checksums.txt и устанавливает в ~/.local/bin (можно переопределить через INSTALL_DIR; зафиксировать версию через VERSION). Архивы для Windows доступны в разделе GitHub Releases. Для сборки из исходников: make setup && make build → bin/mindwalk.

Команды

Без аргументов mindwalk сканирует ~/.claude/projects и ~/.codex/sessions, запускает UI на случайном локальном порту и открывает браузер:

• mindwalk serve [--port N] [--no-open] [--claude-dir DIR] [--codex-dir DIR]
• mindwalk open [--no-open] <session.jsonl> — открыть конкретную сессию
• mindwalk build <repo> [-o out] — записать JSON карты репозитория
• mindwalk trace <session> [-o out] — записать нормализованный JSON трейса

Чтение визуализации

• Древовидный вид / Вид ландшафта — репозиторий в виде радиального дерева или древовидной карты; интенсивность свечения ∝ глубине и частоте касания файла.
• Состояния касания — каждый файл сохраняет самое глубокое касание: замечен (болотно-зеленый), прочитан (лунно-белый), отредактирован (теплый янтарь), не посещен (темный).
• HUD сворачивает сигналы трения — частота ошибок, измененные файлы, правки после последней проверки — в обзорную полосу.
• Панель воспроизведения — ползунок или воспроизведение по сегментированной гистограмме. Шкала в зависимости от типа: наблюдение (поиск, чтение, exec) остается холодным, мутация (правка, проверка) светится теплым.
• Метки временной шкалы — ◇ сжатие контекста, ○ запуск подчиненного агента, › действия пользователя; клик для перехода.
• Инспектор — кликните по файлу, чтобы закрепить его историю посещений; кликните по строке посещения, чтобы переместить курсор.
• Горячие клавиши: Space пауза/воспроизведение · ←/→ шаг (⇧×10) · Home/End в конец · S скорость · E следующее редактирование · X следующая ошибка · M следующая метка · ⌘B панель сессии.

Под капотом

Два отдельных артефакта: трейс (нормализованный поток событий касания файлов из логов сессии через адаптеры в internal/adapter) и карта города (детерминированное представление репозитория в internal/citymap). Локальный Go-сервер (internal/server) объединяет их и отдает фронтенду на React/Three.js (web). Контракты схем хранятся в schema/.

Одно и то же дерево всегда дает одну и ту же карту, поэтому воспроизведения можно сравнивать между сессиями. Данные сессии не покидают вашу машину — полностью локально.