Mindwalk 0.3.0 공개…Codex·Claude Code 세션을 3D 저장소 지도에서 재생

Mindwalk 공식 GitHub 저장소와 릴리스에 따르면 오픈소스 개발자 도구 Mindwalk 0.3.0이 7월 18일 공개됐다. 이 도구는 Codex와 Claude Code의 세션 로그를 코드 저장소의 3D 지도 위에서 재생해 에이전트가 어느 파일을 찾고 읽고 수정했는지 보여준다.

코딩 에이전트의 원본 세션 로그에는 도구 호출과 명령 실행이 시간순으로 남지만, 작업 범위가 저장소 전체에서 어떤 모양을 이루는지 파악하려면 파일별 기록을 다시 연결해야 한다. Mindwalk는 저장소 구조를 방사형 트리 또는 지형 형태로 그린 뒤 에이전트가 접근한 위치에 빛을 표시한다. 파일 상태는 발견, 읽기, 수정, 미방문으로 나뉘며 저장소에서 사라진 파일도 와이어프레임으로 남긴다.

재생 화면에서는 검색·읽기·실행 같은 관찰 작업과 수정·검증 작업을 서로 다른 색 계열로 구분한다. 사용자는 시간 막대를 움직여 특정 시점으로 이동하거나 오류, 편집, 컨텍스트 압축, 사용자 입력 지점을 찾아갈 수 있다. 재생 장면은 브라우저에서 WebM 파일로 내보낼 수 있다.

v0.3.0에서 추가된 Agent Lens는 한 세션이 실행한 서브에이전트의 흔적을 같은 저장소 지도에서 따로 볼 수 있게 한다. 이번 릴리스는 중첩된 Codex 실행 요약 표시와 UTF-8 문자열 처리도 보완했다. 프로젝트는 저장소 지도를 같은 입력에서 같은 결과가 나오는 결정론적 구조로 만들기 때문에 여러 세션의 탐색 범위를 비교할 수 있다고 설명한다.

Mindwalk는 단일 Go 바이너리가 세션 로그를 읽고 로컬 서버를 띄운 뒤 React와 Three.js 기반 화면을 브라우저에 제공하는 구조다. 기본 실행 시 사용자의 Claude Code 프로젝트 폴더와 Codex 세션 폴더를 찾아 목록을 구성한다. 특정 세션 파일만 열거나 세션 없이 저장소 지도만 만드는 명령도 제공한다.

프로젝트 문서에 따르면 세션 열람 과정에서는 데이터를 외부로 보내지 않는다. 다만 사용자가 세션 평가 기능을 직접 실행하면 작업 지시 문구와 파일 경로, 이벤트 요약이 사용자의 Claude 또는 Codex CLI가 연결한 모델로 전송된다. 평가 프로세스는 도구와 MCP 서버, 사용자·프로젝트 설정, 세션 저장 기능을 사용하지 않도록 분리돼 있다고 개발자는 설명했다. 이 내용은 프로젝트 문서를 기준으로 한 것으로, 독립적인 보안 감사 결과는 공개되지 않았다.

세션 평가는 에이전트의 탐색 범위와 우회, 검증 과정을 타임라인 이벤트에 연결해 보여준다. 보고서는 세션별로 로컬에 저장되며 원본 로그가 바뀌면 오래된 상태로 표시된다. 프로젝트는 세션 흔적, 저장소 지도, 평가 보고서를 별도 자료 구조로 나눠 시각화와 평가가 서로 직접 의존하지 않도록 설계했다.

Mindwalk는 MIT 라이선스로 공개됐다. 코딩 에이전트 작업을 검토하는 팀에는 원본 JSONL을 처음부터 읽지 않고도 수정 범위와 탐색 경로를 살펴볼 수 있는 보조 수단이 될 수 있다. 다만 세션 로그에는 작업 지시와 파일 경로, 명령 실행 결과가 포함될 수 있으므로 조직 환경에서는 로컬 서버 접근 범위와 로그 보관 정책, 선택적 평가 기능의 외부 전송 여부를 함께 검토해야 한다.

출처: Mindwalk 공식 GitHub 저장소 https://github.com/cosmtrek/mindwalk
출처: Mindwalk v0.3.0 공식 릴리스 https://github.com/cosmtrek/mindwalk/releases/tag/v0.3.0