mindwalk의 개요
mindwalk는 코딩 에이전트가 디스크에 남긴 세션 로그를 읽어 코드베이스 지도 위에서 재생합니다. 에이전트가 파일을 검색하고 읽고 편집할 때 파일이 빛나므로, 어디를 탐색했는지, 변경이 얼마나 퍼졌는지, 작업을 검증했는지 한눈에 볼 수 있습니다. 타임라인은 컨텍스트 압축, 서브에이전트 실행, 사용자 턴을 표시하고, 서브에이전트마다 그 흔적을 따로 재생할 수 있습니다.
선택적인 평가 단계도 있습니다. 사용자의 `claude`나 `codex` CLI가 요청을 바탕으로 성공 기준을 작성하고, 고정된 네 가지 차원(탐색, 범위, 헤맴, 검증)으로 세션을 채점하며, 모든 판단은 타임라인 이벤트와 연결됩니다.
React와 Three.js 프런트엔드를 갖춘 단일 Go 바이너리이며, MIT 라이선스이고, Go 라이브 리로드 도구 Air를 만든 Ricko Yu의 작품입니다. v0.5.0은 2026년 8월 7일에 나왔고, 마지막 커밋은 8월 10일이며, 마지막 확인 때 저장소의 스타는 약 1,400개였습니다.
mindwalk, 쓸 만한 가치가 있습니까?
mindwalk는 원시 JSONL 로그로는 답할 수 없는 질문, 즉 에이전트가 무엇을 관련 있다고 여겼는지에 답합니다. 파일마다 가장 깊은 접촉(봄, 읽음, 편집함)이 남고, 삭제된 파일은 와이어프레임으로 남으며, 재생 히스토그램은 관찰을 차가운 색, 변경을 따뜻한 색으로 칠합니다. 그래서 읽기 전에 편집한 에이전트는 바로 드러납니다. 리뷰 띠는 오류율, 반복 수정된 파일, 마지막 검증 이후의 편집을 한 줄로 접어 보여 주며, 리뷰어가 매일 쓸 부분이 바로 이것입니다.
개인정보 설계는 신중합니다. 보기는 완전히 로컬이며 아무것도 보내지 않고, 설치 프로그램은 공개된 체크섬으로 바이너리를 검증합니다. 평가는 선택 사항이며 도구, MCP 서버, 설정 없이 사용자의 CLI를 실행하고, 해당 세션의 사용자 메시지, 파일 경로, 한 줄짜리 이벤트 요약만 보냅니다. 판정은 모델에 맡기지 않고 판단의 심각도를 기계적으로 집계하며, 작업 문구가 바뀌지 않았으면 기준을 재사용하므로 반복 점수를 비교할 수 있습니다.
제약은 지원 범위입니다. Claude Code, Codex, pi 로그를 읽습니다. OpenCode, Crush, Antigravity 지원은 요청과 열린 풀 리퀘스트로만 존재하며, 9월 9일에 열린 아홉 편짜리 Crush 시리즈도 마지막 확인 때까지 병합되지 않았습니다. 열린 이슈와 풀 리퀘스트 17개, 7월 11일부터 8월 7일 사이 릴리스 다섯 번, 8월 10일 이후 병합 없음이라는 현황을 보면 유지되는 제품이라기보다 동작하는 v0.5입니다.
ccusage를 대체하기보다 그 옆에 놓입니다. ccusage는 세션에 든 비용을, mindwalk는 세션이 한 일을 보여 줍니다. 둘 다 팀 단위 보기는 없고, mindwalk는 디스크에 남은 세션만 볼 수 있으므로 Claude Code의 기본 30일 기록 정리가 거슬러 올라갈 수 있는 범위를 제한합니다.
제 역할을 하는 곳
Claude Code가 연 풀 리퀘스트를 검토하는 테크 리드
에이전트의 변경이 티켓 범위 안에 머물렀는지 확인하기
`mindwalk open <session.jsonl>`로 세션을 열고 타임라인을 훑습니다. 예상한 디렉터리 밖의 주황빛은 diff를 꼼꼼히 읽으라는 신호입니다. 무료이며 세션당 1분 정도 걸립니다.
CLAUDE.md나 스킬을 다듬는 개발자
새 지침이 에이전트의 편집 전 탐색량을 바꾸는지 확인하기
변경 전후 세션에 `mindwalk analyze`를 돌리고 탐색과 검증 차원을 비교합니다. 분석마다 자신의 Claude나 Codex 요금제로 최대 두 번 호출합니다.
개발자 다섯 명과 에이전트 시범 운영을 하는 엔지니어링 매니저
좋은 에이전트 세션과 나쁜 세션의 구체적인 예를 팀에 보여 주기
덱 메뉴에서 재생을 .webm으로 내보내면 클라이언트 쪽에서 녹화되며, 이를 회고에서 공유합니다. 공유 서버가 없으므로 개발자마다 자기 기기에서 내보냅니다.
도입 전 확인할 점
- 설정
- `curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh`가 체크섬 확인 후 ~/.local/bin에 설치합니다. Windows 아카이브는 GitHub Releases에 있습니다. `mindwalk`를 실행하면 ~/.claude/projects, ~/.codex/sessions, ~/.pi/agent/sessions를 훑고 브라우저를 엽니다.
- 연동
- Claude Code, Codex, pi용 세션 어댑터. 평가 심사자로 `claude`나 `codex` CLI. 트레이스, 저장소 지도, 보고서의 JSON 내보내기와 schema/의 스키마. Nix 사용자는 numtide/llm-agents flake로 설치할 수 있습니다.
- 데이터와 개인정보
- 보기는 로컬이며 아무것도 보내지 않습니다. 평가는 실행할 때만 한 세션의 사용자 메시지, 파일 경로, 이벤트 요약을 사용자 CLI 뒤의 모델로 보냅니다. 보고서는 ~/.mindwalk/reports에 캐시됩니다. MIT 라이선스.
- 대규모 사용 시 비용
- 무료입니다. 평가는 기존 요금제로 세션당 최대 두 번의 모델 호출이 듭니다. 호스팅이나 유료 에디션은 없습니다.
- 제한
- 에이전트 형식 세 가지만 지원. 2026년 8월 이후 병합된 변경 없음. 기기마다 임의의 로컬 포트에서 서비스하며 다중 사용자 보기 없음. 기록은 에이전트가 아직 보관 중인 로그로 제한됨.
좋은 점
- 완전히 로컬인 보기, 평가하지 않으면 아무것도 전송하지 않음
- 서브에이전트 흔적을 같은 지도에서 재생 가능
- 근거와 연결된 평가와 기계적 판정
- 체크섬 검증 설치 프로그램을 갖춘 단일 Go 바이너리
아쉬운 점
- 현재는 Claude Code, Codex, pi 로그만 지원
- 2026년 8월 10일 이후 병합된 변경 없음
- 팀이나 여러 기기를 아우르는 보기 없음
- 평가에 자신의 요금제 토큰이 듦
추천 대상
코딩 에이전트의 작업을 검토하며 diff를 읽기 전에 에이전트의 발자취를 보고 싶은 개발자와 테크 리드.
mindwalk 대안
mindwalk: 자주 묻는 질문
- mindwalk, 쓸 만한 가치가 있습니까?
- mindwalk를 쓰면 에이전트가 저장소에서 어디를 헤맸는지 몇 초 만에 볼 수 있습니다. 다만 8월 이후 개발이 조용해진 어린 도구입니다. 평점은 5점 만점에 3.6점입니다.
- mindwalk의 가격은 얼마입니까?
- MIT의 무료 오픈소스입니다. 세션 평가는 기존 Claude나 Codex 요금제를 씁니다.
- mindwalk의 단점은 무엇입니까?
- 현재는 Claude Code, Codex, pi 로그만 지원; 2026년 8월 10일 이후 병합된 변경 없음; 팀이나 여러 기기를 아우르는 보기 없음; 평가에 자신의 요금제 토큰이 듦.
- mindwalk에 적합한 사람은 누구입니까?
- 코딩 에이전트의 작업을 검토하며 diff를 읽기 전에 에이전트의 발자취를 보고 싶은 개발자와 테크 리드.
- 팀이나 프로덕션 환경에서 mindwalk의 비용은 얼마입니까?
- 무료입니다. 평가는 기존 요금제로 세션당 최대 두 번의 모델 호출이 듭니다. 호스팅이나 유료 에디션은 없습니다.
- mindwalk에 회사 데이터를 맡겨도 안전합니까?
- 보기는 로컬이며 아무것도 보내지 않습니다. 평가는 실행할 때만 한 세션의 사용자 메시지, 파일 경로, 이벤트 요약을 사용자 CLI 뒤의 모델로 보냅니다. 보고서는 ~/.mindwalk/reports에 캐시됩니다. MIT 라이선스.
- mindwalk의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 ccusage, claude-mem 및 Graphify입니다.
답변 확인일: 2026년 10월 26일.
