코딩 에이전트의 작업 경로를 3D 지도로 보여주는 Mindwalk

코딩 에이전트의 작업 경로를 3D 지도로 보여주는 Mindwalk

AI 뉴스 썸네일

Claude Code나 Codex가 어떤 파일을 읽고 고쳤는지는 세션 기록에서 찾을 수 있어요. 하지만 에이전트가 저장소를 얼마나 넓게 돌아다녔는지, 요청과 무관한 영역까지 건드렸는지는 긴 JSONL만으로 파악하기 어려워요. Mindwalk는 이 경로를 빛이 움직이는 3D 지도로 바꿔 보여주는 오픈소스 도구예요. 1

핵심 요약

구분	내용	확인할 점
세션 재생	Claude Code와 Codex 기록을 저장소 지도 위에서 재생해요	탐색 범위와 수정 흐름을 시간순으로 볼 수 있어요
지도 표현	Tree와 Terrain 화면에서 파일 상태를 색과 밝기로 나눠요	읽기, 수정, 미방문 파일이 한눈에 구분돼요
실행 방식	하나의 Go 바이너리가 로컬 서버와 웹 화면을 제공해요	단순 열람 중에는 세션 데이터가 외부로 나가지 않아요
세션 평가	설치된 Claude 또는 Codex CLI로 탐색과 검증 과정을 평가할 수 있어요	평가를 직접 실행할 때는 해당 세션 요약이 모델로 전송돼요

1. 긴 세션 기록을 작업 지도와 타임라인으로 바꿔요

Mindwalk는 저장소를 어두운 야간 지도처럼 그려요. 코딩 에이전트가 검색하거나 읽은 파일에는 차가운 계열의 빛이 들어오고, 수정하거나 검증한 구간은 따뜻한 계열로 표시돼요. 파일을 많이 방문할수록 빛이 강해져서 작업이 몰린 영역과 거의 보지 않은 영역을 비교할 수 있어요. 저장소에서 이미 사라진 파일도 와이어프레임 형태로 남겨 과거 세션의 흔적을 놓치지 않아요. 2

저장소 구조는 방사형 Tree 화면과 평면형 Terrain 화면으로 볼 수 있어요. 파일 하나를 선택하면 방문 기록이 열리고, 특정 기록을 누르면 재생 위치가 그 시점으로 이동해요. 재생 막대에는 컨텍스트 압축, 사용자 입력, 하위 작업 실행 시점도 표시돼요. 긴 작업에서 방향이 바뀐 구간이나 수정이 집중된 순간을 원본 로그보다 빠르게 찾을 수 있는 구성이에요.

728x90

화면 상단의 지표는 오류 비율, 반복해서 고친 파일, 마지막 검증 뒤에 다시 수정된 파일을 묶어 보여줘요. 여러 작업이 동시에 실행된 세션은 각각의 경로를 같은 지도에서 따로 재생할 수 있어요. 재생 결과는 브라우저에서 WebM 영상으로 내보낼 수도 있어 코드 리뷰나 회고 자료로 남기기 편해요.

설치는 Go로 빌드된 단일 실행 파일을 쓰고, 기본 실행 시 `~/.claude/projects`와 `~/.codex/sessions`를 찾아요. 특정 JSONL 파일만 열거나 세션 없이 저장소 지도만 만드는 명령도 제공해요. 내부 화면은 로컬 Go 서버가 React와 Three.js 기반 프런트엔드를 띄우는 방식이에요. 프로젝트는 MIT 라이선스로 공개돼 있어요. 2

코드 리뷰에서 어디에 쓸 수 있나요

에이전트가 최종 diff를 제대로 만들었더라도 그 과정이 효율적이었다고 단정하기는 어려워요. 요청이 작은데 저장소 전체를 훑었다면 컨텍스트와 실행 시간을 많이 썼을 수 있어요. 반대로 핵심 모듈을 거의 읽지 않고 바로 수정했다면 우연히 테스트만 통과했을 가능성도 살펴봐야 해요. Mindwalk의 지도와 타임라인은 이런 차이를 파일 방문 범위와 순서로 확인하게 해줘요.

팀에서는 같은 작업을 여러 모델이나 지시 방식으로 실행한 뒤 경로를 비교할 수 있어요. 저장소 배치가 결정론적으로 만들어지므로 같은 코드 구조라면 세션마다 파일 위치가 달라지지 않아요. 결과 코드만 비교할 때 놓치기 쉬운 탐색 습관, 반복 수정, 검증 시점을 함께 볼 수 있어요.

로컬 열람과 선택형 평가를 구분해야 해요

세션을 열어 지도로 보는 과정은 로컬에서 처리돼요. 다만 선택 기능인 세션 평가를 실행하면 사용자 메시지 문구, 파일 경로, 이벤트 요약이 설치된 `claude` 또는 `codex` CLI가 사용하는 모델로 전송돼요. 다른 세션은 포함하지 않고, 평가 결과는 `~/.mindwalk/reports`에 저장돼요. 민감한 저장소에서 쓸 때는 단순 열람과 모델 평가의 데이터 경로가 다르다는 점을 먼저 확인하는 편이 좋아요. 2

왜 중요한가요

코딩 에이전트 도구는 완성된 코드와 테스트 결과를 주로 보여줘요. 실제 작업 과정에는 어떤 파일을 후보로 봤는지, 어디서 헤맸는지, 검증 뒤 무엇을 다시 고쳤는지도 남아 있어요. Mindwalk는 이 기록을 리뷰 가능한 화면으로 바꿔 개발자가 결과뿐 아니라 작업 경로까지 점검하게 해줘요. 2

도입 판단에는 시각적 완성도보다 실제 리뷰 질문에 답할 수 있는지가 중요해요. 작은 수정에서 탐색 범위가 과도했는지, 관련 모듈을 충분히 읽었는지, 오류 뒤 같은 파일을 반복해서 고쳤는지 확인해 보세요. 이런 정보가 코드 품질이나 비용 문제를 찾는 데 꾸준히 도움이 된다면 팀의 에이전트 운영 기록으로 쓸 가치가 있어요.

참고 자료

1. Mindwalk - 코딩 에이전트 세션을 코드베이스의 3D 지도 위에서 재생하는 시각화 도구 — GeekNews
2. cosmtrek/mindwalk — GitHub