Mindwalk

세션 재생 및 시각화

mindwalk serve 명령어를 실행하면 ~/.claude/projects, ~/.codex/sessions, ~/.pi/agent/sessions 디렉터리를 스캔하여 세션을 찾고, 로컬 포트에서 UI를 제공합니다. 사용자는 브라우저에서 3D 맵을 통해 에이전트의 활동을 관찰할 수 있습니다.

파일 터치 상태 표시

각 파일은 가장 깊은 터치 상태를 유지합니다: seen (moss green), read (moonlight blue), edited (warm amber), unvisited (dark). 세션에서 터치되었지만 더 이상 저장소에 없는 파일은 wireframe 유령으로 표시됩니다. HUD는 오류율, churned 파일, 마지막 검증 후 편집과 같은 마찰 신호를 리뷰 스트립에 접어넣습니다.

재생 데크 및 타임라인 마크

사용자는 버킷화된 히스토그램 위에서 세션을 스크럽하거나 재생할 수 있습니다. 바는 관찰(검색, 읽기, 실행)은 쿨톤, 변형(편집, 검증)은 웜톤으로 표시되어 편집 단계를 한눈에 식별할 수 있습니다. 타임라인 마크(◇ context compactions, ○ subagent launches, › user turns)는 클릭하여 이동할 수 있는 대상입니다.

에이전트 렌즈 및 인스펙터

세션이 서브에이전트를 lancement했을 때, HUD는 서브에이전트 수와 에이전트 패널을 표시합니다. 사용자는 렌즈를 선택하여 동일한 맵에서 서브에이전트의 트레이스를 재생한 후 메인 트레이스로 돌아올 수 있습니다. 파일을 클릭하면 방문 기록을 고정하고, 방문 행을 클릭하면 해당 순간으로 재생 헤드를 이동할 수 있습니다.

세션 평가 (선택적)

mindwalk analyze 명령어를 실행하면 로컬 에이전트 CLI(예: claude 또는 codex)를 사용하여 세션을 평가할 수 있습니다. 평가 보고서는 프로세스 차원(탐색, 범위, 방황, 검증)과 작업별 점수표로 구성되며, 모든 발견은 타임라인 이벤트를 통해 검증 가능합니다. 평가는 사용자의 요청 wording에서 기준을 초안하고, 세션 요약만 모델에 전송하며, 다른 세션이나 사용자 설정은 포함되지 않습니다.

다운로드·설치 방법

공식 설치 스크립트를 사용하여 Mindwalk을 설치할 수 있습니다. 다음 명령을 터미널에서 실행합니다:

curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh

설치 후 PATH에 ~/.local/bin을 추가하면 mindwalk 명령을 사용할 수 있습니다:

export PATH="$HOME/.local/bin:$PATH"

Windows 사용자는 GitHub Releases에서 아카이브를 다운로드하여 수동으로 설치할 수 있습니다. 소스에서 빌드하려면 make setup && make build를 실행하여 bin/mindwalk 바이너리를 생성합니다.

기본 사용법/명령어

인수 없이 mindwalk을 실행하면 기본 세션 디렉터리를 스캔하고 로컬 브라우저에서 UI를 엽니다. 주요 하위 명령어는 다음과 같습니다:

• mindwalk serve [–port N] [–no-open] [–claude-dir DIR] [–codex-dir DIR] [–pi-dir DIR] : 세션을 제공하고 UI를 시작
• mindwalk open [–no-open] : 특정 세션 파일 열기
• mindwalk map [–no-open] : 세션 없이 저장소 맵 열기
• mindwalk build [-o out] : 저장소 시티맵 JSON 작성
• mindwalk trace [-o out] : 정규화된 트레이스 JSON 작성
• mindwalk analyze [–judge claude|codex] [–model name] [–no-rubric] : 세션 평가 (선택적)

키보드 단축키도 지원됩니다: Space (재생/일시정지), ←/→ (단계 이동, Shift와 함께 10배속), Home/End (시작/끝으로 이동), S (속도 조절), V (뷰 전환), E (다음 편집으로 이동), X (다음 오류로 이동), M (다음 마크로 이동), ⌘B (세션 레일 토글).

이런 경우에 유용합니다

코딩 에이전트의 동작을 이해하고 싶은 개발자에게 유용합니다. 예를 들어, 에이전트가 어떤 파일을 읽었는지, 어디서 헤맸는지, 수정이 의도 범위를 벗어났는지 등을 시각적으로 확인할 수 있습니다. 이는 에이전트 기반 개발 워크플로우에서 신뢰성과 디버깅을 향상시키는 데 도움이 됩니다.

지원 환경·시스템 요구사항

Mindwalk은 Go로 작성된 단일 바이너리로 배포됩니다. 공식적으로 지원되는 플랫폼은 명시되지 않았지만, 소스에서 빌드하려면 Go 도구 체인이 필요하며, 배포된 바이너리는 주요 데스크톱 운영 체제에서 실행될 수 있습니다. Windows 사용자는 GitHub Releases에서 제공하는 아카이브를 사용할 수 있습니다.

최신 버전·업데이트

현재 버전은 0.5.0이며, 2026년 9월 12일에 마지막으로 업데이트되었습니다. 자세한 변경 사항은 GitHub 저장소의 커밋 히스토리를 참조하십시오.

제한 사항·확인 사항

세션 평가 기능을 사용할 때는 로컬에 claude 또는 codex CLI가 설치되어 있어야 하며, 해당 CLI가 실행 가능한 환경이어야 합니다. 평가 중에는 세션 요약(사용자 메시지 wording, 파일 경로, 이벤트 다이제스트)만 해당 모델에 전송되며, 다른 세션이나 사용자 설정은 포함되지 않습니다. 평가 결과는 ~/.mindwalk/reports에 캐시되며, 세션 내용이 변경되면 캐시가 무효화됩니다.

화면으로 보는 주요 기능

메인 렌즈 화면

Mindwalk 애플리케이션의 메인 렌즈 화면을 보여줍니다. 상단에는 'mindwalk' 로고와 'LENS Main' 탭이 있으며, 그 아래에 '823e862 gpt-5.6-sol 103 files'라는 텍스트가 있습니다. 화면 상단에는 'EDITED 15', 'READ 9→10', 'SEEN 18', 'UNVISITED 61→60', 'GHOST 1'과 같은 상태 카운터가 있으며, 각각 주황색, 파란색, 녹색, 회색 원형 아이콘으로 구분됩니다. 그 아래에는 '335 calls', '10 turns', '15 subagents', '1 compaction', '770 KB output', 're-reads ~40%', 'REVIEW ~27 errors', '7 files edited 3+ times', 'verified after final edit'와 같은 정보가 나열되어 있습니다. 중앙에는 3D 큐브 구조의 시각화가 있으며, 'codex', 'adapter', 'server', 'internal', 'judge', 'schema', 'model', 'citymap', 'web', 'playback', 'api', 'testdata', 'skills' 등의 레이블이 붙은 블록들이 있습니다. 하단에는 시간 축이 있는 타임라인과 'exec set -e go build -o /tmp/mindwalk-headless ./cmd/mindwalk/tmp/mindwalk-headless serve –no-op… -> 0 targets, 0 outside'라는 명령줄이 표시되어 있습니다. 오른쪽 상단에는 삼각형, 시계, 사람, 설정 아이콘으로 구성된 도구 모음이 있습니다.

에이전트 선택 패널

Mindwalk 애플리케이션의 메인 렌즈 화면에 에이전트 선택 패널이 열려 있는 상태를 보여줍니다. 패널 제목은 'Agents'이며, 'Choose one trace at a time'라는 지시문이 있습니다. 'Main' 에이전트가 'CURRENT' 상태로 선택되어 있으며, 'Root trace'라는 설명이 있습니다. 그 아래에는 'Noether', 'Socrates', 'Boole', 'Faraday', 'Chandrasekhar', 'Curie', 'Poincare', 'Mendel', 'Popper', 'Ansccombe' 등의 에이전트 목록이 있으며, 각각의 에이전트 이름 옆에는 이벤트 수와 고유한 식별자(예: gAAAAABqUf0wm0n9N1kWQ2kmF…)가 표시되어 있습니다. 각 항목 오른쪽에는 정보 아이콘(?)이 있습니다. 화면의 나머지 부분은 첫 번째 스크린샷과 동일한 3D 큐브 시각화와 하단 타임라인을 포함하고 있습니다.