Mindwalk: Візуалізація та відтворення сесій ШІ-агентів на 3D-карті кодової бази
Mindwalk — це локальний інструмент на Go, який візуалізує логи сесій Claude Code та Codex у вигляді інтерактивних 3D-карт. Він допомагає розробникам відстежувати навігацію, редагування та помилки ШІ-агента безпосередньо в локальній структурі репозиторію.
Вплив: Середній
Чому це важливо
Ви можете проводити аудит того, як саме кодувальні агенти досліджують, читають та редагують файли, щоб оптимізувати витрати токенів і виявляти логічні прогалини.
TL;DR
- 01Mindwalk відображає модифікації файлів у вигляді яскравих теплових зон, показуючи, де саме кодувальний агент читав або редагував код.
- 02Інструмент працює повністю локально як бінарний файл Go, захищаючи конфіденційну структуру репозиторію від витоку.
- 03Візуальні таймлайни виділяють системні події, такі як запуск субагентів та стиснення системних промптів.
Ключові факти
- Підтримувані формати
- Claude Code, Codex
- Основний технологічний стек
- Сервер на Go, React, Three.js
- Модель конфіденційності
- 100% Локально
Локальний аудит агентів
Mindwalk аналізує логи сесій Claude Code та Codex повністю локально, гарантуючи, що конфіденційні метадані кодової бази або телеметрія не залишать вашу машину. Він перетворює сирі трасування JSONL на інтерактивні 3D-представлення Three.js (радіальні дерева або карти дерев), де вузли файлів світяться залежно від глибини та частоти звернення під час роботи агента.
Кольорове кодування шляху виконання
Файли на 3D-карті оформлені відповідно до найглибшого рівня взаємодії: невідвідані файли залишаються темними, тоді як змінені відображаються зеленим (переглянуті), місячно-білим (прочитані) або бурштиновим (відредаговані). Панель приладів відстежує сигнали тертя, включаючи фази мутацій, стиснення контексту, запуски субагентів та помилки, дозволяючи розробникам візуально оцінити хід думок агента.
Інтерфейс командного рядка
Запустіть скрипт встановлення або зберіть бінарний файл безпосередньо з вихідного коду за допомогою команди make build. Запустіть сервер за допомогою mindwalk serve, який автоматично сканує стандартні каталоги та запускає локальний вебклієнт на випадковому порту.
Спробуй за 2 хвилини
curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh
mindwalk servebash
✓ Коли використовувати
- При аналізі довгих, складних сесій Claude Code або Codex у великих кодових базах.
- При налагодженні галюцинацій агентів або проблем із роздуванням вікна контексту.
- Якщо ви хочете візуально перевірити зміни, внесені агентом, замість читання сирих логів JSONL.
✕ Коли НЕ варто
- Для агентів, які не зберігають стандартні формати сесій JSONL від Claude Code або Codex.
- При роботі на ізольованих машинах без середовища виконання Go або Node.
Що зробити сьогодні
- Запустіть скрипт швидкого встановлення для налаштування Mindwalk локально.
- Виконайте команду serve для сканування наявних логів сесії Claude Code.
- Керуйте 3D-моделлю за допомогою клавіатури (пробіл, стрілки, E, X) для аналізу нещодавніх редагувань.
Що каже спільнота
“This can help you evaluate agentic capabilites of various llm's. How they explore codebase.”
“If you have a big codebase, text diff is not faster to see what was done here and there, then a visual overview.”
Джерела