Mindwalk: Công cụ trực quan hóa hoạt động của AI Agent trên bản đồ 3D mã nguồn

Một công cụ trực quan hóa giúp phát lại các phiên làm việc của coding-agent trên bản đồ 3D của codebase.

Bản demo 30 giây — hãy bật âm thanh.

Vấn đề

Nhật ký phiên làm việc ghi lại những gì agent đã thực hiện, nhưng không cho thấy cách nó hiểu nhiệm vụ: những phần nào của repo được coi là liên quan, nó đã khám phá ở đâu trước khi hành động, liệu dấu vết của nó có khớp với phạm vi bạn mong muốn hay không. Việc đọc tệp JSONL thô từng dòng một không giải đáp được bất kỳ điều nào trong số đó.

Ý tưởng

Vẽ repository như một bản đồ về đêm và phát lại phiên làm việc dưới dạng ánh sáng di chuyển qua đó: nơi agent tìm kiếm, đọc và chỉnh sửa, bản đồ sẽ phát sáng — mọi thứ khác vẫn tối. Cách agent hiểu nhiệm vụ trở thành một hình khối mà bạn có thể nhìn thấy trong nháy mắt. Một tệp nhị phân Go sẽ đọc nhật ký phiên của Claude Code và Codex, hoàn toàn cục bộ; không có dữ liệu phiên nào rời khỏi máy của bạn.

Bắt đầu nhanh

Trình cài đặt sẽ xác minh tệp nhị phân dựa trên checksums.txt và cài đặt vào ~/.local/bin (ghi đè bằng INSTALL_DIR; ghim một bản phát hành bằng VERSION). Các tệp lưu trữ cho Windows có trên GitHub Releases. Để build từ mã nguồn: make setup && make build → bin/mindwalk.

Nếu không có đối số, mindwalk sẽ quét ~/.claude/projects và ~/.codex/sessions, phục vụ giao diện người dùng trên một cổng cục bộ ngẫu nhiên và mở trình duyệt:

Đọc hình ảnh

Bàn phím: Space phát/tạm dừng · ←/→ bước (⇧ ×10) · Home/End kết thúc · S tốc độ · E chỉnh sửa tiếp theo · X lỗi tiếp theo · M đánh dấu tiếp theo · ⌘B thanh phiên làm việc.

Cơ chế hoạt động

Hai thành phần, được giữ tách biệt một cách có chủ đích:

Một máy chủ Go cục bộ (internal/server) kết nối cả hai và phục vụ giao diện React/Three.js (web). schema/ phản ánh các hợp đồng JSON đã xuất.

Đóng góp

Các vấn đề (issues) và pull request luôn được chào đón. Để thiết lập môi trường phát triển:

Các quy tắc cơ bản (xem AGENTS.md để biết ghi chú kiến trúc đầy đủ):