Mindwalk - 코딩 에이전트 세션을 코드베이스의 3D 지도 위에서 재생하는 시각화 도구
요약
Mindwalk는 코딩 에이전트의 세션 로그를 3D 지도에 시각화하여, 에이전트가 어떤 영역을 탐색하고 이해했는지 직관적으로 보여주는 도구입니다. 저장소 전체를 '야간 지도'로 표현하며, 파일별 터치 상태(seen, read, edited 등)와 에이전트의 활동 경로를 색상과 빛 강도로 구현합니다. 이를 통해 단순 로그로는 알 수 없었던 작업 이해도를 한눈에 파악할 수 있습니다.
핵심 포인트
- 저장소 전체를 3D '야간 지도'로 시각화하여 에이전트의 작업 범위를 직관적으로 보여줍니다.
- 파일별 터치 상태(seen, read, edited)와 활동 경로를 색상 및 빛 강도로 구분합니다.
- 세션 재생을 통해 편집/검증 구간을 강조하고, 컨텍스트 압축 마크로 시간 흐름을 분석할 수 있습니다.
- Go 바이너리 기반으로 로컬에서 동작하며, React/Three.js 프론트엔드로 구현되었습니다.
- 세션 로그는 에이전트가 무엇을 했는지 기록하지만,
작업을 어떻게 이해했는지(관련 영역 판단, 탐색 위치, 작업 범위 일치 여부)는 담지 못하며, 원본 JSONL을 읽어서는 알 수 없음 - 저장소를
야간 지도로 그려, 에이전트가 검색/읽기/수정한 위치는 빛나고 나머지는 어둡게 유지해 에이전트의 작업 이해를 한눈에 볼 수 있게 표현 - 싱글
Go 바이너리가 Claude Code와 Codex 세션 로그를 읽으며, 뷰잉 과정은 완전히 로컬에서 동작함
Tree/Terrain 뷰로 저장소를 방사형 트리 또는 트리맵 평면으로 표현, 파일이 깊고 자주 터치될수록 빛 강도 증가 - 파일별
터치 상태를 색으로 구분 — seen(녹색), read(파랑), edited(호박색), unvisited(어두움) - 세션이 터치했으나 저장소에서 사라진 파일은
와이어프레임 유령으로 남음 - HUD가 오류율, churn된 파일, 마지막 verify 이후 수정 등
마찰 신호를 묶어서 표시
Playback deck으로 버킷화된 히스토그램 위에서 세션을 스크럽/재생, 관찰(검색/읽기/실행)은 차갑게 변형(수정/verify)은 따뜻하게 배치해 편집 구간이 두드러짐
- 재생을 클라이언트 측에서 전부
.webm
으로 내보내기 지원
Timeline marks로 컨텍스트 압축(◇), 서브에이전트 실행(○), 사용자 턴(›)을 표시하고 클릭 시 해당 지점으로 점프 가능
Agent lenses로 세션이 실행한 서브에이전트의 트레이스를 같은 지도 위에서 재생하고 메인 트레이스로 복귀 가능
세션 평가 기능으로 로컬 CLI에 탐색/범위/방황/검증 판정을 요청, 모든 발견은 클릭 가능한 타임라인 이벤트에 앵커링
- 평가 실행 시에만 세션 요약(메시지 문구, 파일 경로, 한 줄 이벤트 요약)이 사용자 계정의
claude
/codex
CLI 뒤 모델로 전송, 다른 세션은 포함되지 않음
-
내부적으로
trace(정규화된 파일 터치 이벤트 스트림), citymap(결정론적 저장소 레이아웃), report(LLM 판정자의 증거 기반 발견) 세 아티팩트를 의도적으로 분리함 -
로컬 Go 서버가 결합해 React/Three.js 프론트엔드로 서빙
-
MIT 라이선스
댓글과 토론
AI 자동 생성 콘텐츠
본 콘텐츠는 GeekNews의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기