cosmtrek/mindwalk

해결하는 문제

Mindwalk은 코딩 에이전트에서 생성한 원시적인 선형 세션 로그를 코드베이스의 시각적 3D 지도로 변환합니다. 에이전트가 리포지토리를 어떻게 탐색하고 수정했는지 이해하는 문제를 해결합니다 — 어떤 파일이 관련 있었는지, 어디를 방황했는지, 그리고 그 발자국이 의도된 범위와 일치하는지 — 이는 JSONL 로그를 읽기만으로는 파악하기 어려운 부분입니다.

작동 방식

Mindwalk은 리포지토리의 결정론적인 '시티맵'을 생성하고, 에이전트의 세션 재생을 겹쳐 놓습니다. Claude Code, Codex, pi와 같은 다양한 에이전트의 로그를 정규화하기 위해 어댑터를 사용하여 파일 접근 이벤트 스트림으로 변환합니다.

주요 시각적 요소는 다음과 같습니다:

• 지형 및 트리 뷰: 코드베이스는 반경 트리 또는 트리맵으로 렌더링되며, 파일이 얼마나 자주 접촉되었는지에 따라 빛의 강도로 표현됩니다.
• 접촉 상태: 파일은 가장 깊은 상호작용 유형에 따라 색상으로 구분됩니다 (예: 모스 그린 = 확인됨, 문라이트 블루 = 읽음, 웜 앰버 = 수정됨).
• 재생 덱: 타임라인을 통해 세션을 스크롤할 수 있으며, 관찰(쿨 컬러)과 변경(웜 컬러)을 구분할 수 있습니다.
• 에이전트 렌즈: 세션에 하위 에이전트가 포함된 경우, 사용자는 '렌즈'를 전환하여 동일한 지도 위에서 특정 하위 에이전트의 추적 기록을 재생할 수 있습니다.
• 세션 평가: 로컬 에이전트 CLI를 사용하여 프로세스 차원(탐색, 범위, 방황, 검증)과 작업별 스코어카드를 기반으로 세션의 흐름을 평가하는 선택적 기능입니다.

대상 사용자

코드베이스와의 상호작용을 시각화하여 코딩 에이전트의 디버깅, 분석, 성능 평가가 필요한 개발자 및 AI 에이전트 연구자.

주요 특징

• 3D 코드베이스 시각화: 에이전트의 활동을 리포지토리의 3D 지도를 따라 움직이는 빛으로 시각화합니다.
• 로컬 우선: Go 바이너리와 UI는 로컬에서 실행되며, 세션을 보기 위해 외부로 데이터를 전송하지 않습니다.
• 다중 에이전트 지원: Claude Code, Codex, pi의 로그를 지원합니다.
• 하위 에이전트용 렌즈: 복잡한 세션 내에서 하위 에이전트 추적 기록을 분리하고 재생할 수 있습니다.
• 증거 기반 평가: 타임라인 이벤트와 직접 연결되는 LLM 기반 세션 보고서.
• 클라이언트 사이드 동영상 내보내기: 브라우저 내에서 완전히 실행되어 재생 세션을 .webm 파일로 내보낼 수 있습니다.