Mindwalk: Reproduce sesiones de Claude Code/Codex como estelas de luz en un mapa de código 3D

Mindwalk es una herramienta de visualización que reproduce sesiones de agentes de codificación en un mapa 3D de tu base de código. En lugar de mirar registros JSONL sin procesar, obtienes un mapa nocturno donde la luz se mueve a medida que el agente busca, lee y edita, mientras que las partes no tocadas permanecen oscuras.

Qué problema resuelve

Un registro de sesión te dice lo que hizo un agente, pero no cómo entendió la tarea: qué partes del repositorio consideró relevantes, dónde exploró antes de actuar, o si su huella coincidía con tu intención. Leer JSONL línea por línea no responde eso.

Inicio rápido

curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
mindwalk

El instalador verifica el binario contra checksums.txt y lo instala en ~/.local/bin (anula con INSTALL_DIR; fija una versión con VERSION). Los archivos de Windows están en GitHub Releases. Para compilar desde el código fuente: make setup && make build → bin/mindwalk.

Comandos

Sin argumentos, mindwalk escanea ~/.claude/projects y ~/.codex/sessions, sirve la interfaz en un puerto local aleatorio y abre un navegador:

• mindwalk serve [--port N] [--no-open] [--claude-dir DIR] [--codex-dir DIR]
• mindwalk open [--no-open] <session.jsonl> — abre una sesión específica
• mindwalk build <repo> [-o out] — escribe el mapa JSON del repositorio
• mindwalk trace <session> [-o out] — escribe el JSON de traza normalizada

Lectura de la visualización

• Vistas de árbol / terreno — el repo como árbol radial o treemap; la intensidad del brillo ∝ cuán profunda y frecuentemente se tocó un archivo.
• Estados de toque — cada archivo guarda su toque más profundo: visto (verde musgo), leído (blanco luna), editado (ámbar cálido), no visitado (oscuro).
• HUD pliega señales de fricción — tasa de error, archivos modificados, ediciones tras la última verificación — en una tira de revisión.
• Módulo de reproducción — desplázate o reproduce sobre un histograma agrupado. Barras en un espectro frío/cálido: observación (búsqueda, lectura, ejecución) permanece fría, mutación (edición, verificación) brilla cálida.
• Marcas de línea de tiempo — ◇ compactaciones de contexto, ○ lanzamientos de subagentes, › turnos de usuario; haz clic para saltar.
• Inspector — haz clic en un archivo para fijar su historial de visitas; haz clic en una fila de visita para mover el cabezal de reproducción.
• Teclado: Espacio reproducir/pausa · ←/→ paso (⇧×10) · Inicio/Fin extremos · S velocidad · E siguiente edición · X siguiente error · M siguiente marca · ⌘B carril de sesión.

Bajo el capó

Dos artefactos separados: una traza (flujo normalizado de eventos de toque de archivos desde registros de sesión mediante adaptadores en internal/adapter) y un citymap (disposición determinista del repositorio en internal/citymap). Un servidor Go local (internal/server) los une y sirve el frontend React/Three.js (web). Los contratos de esquema viven en schema/.

El mismo árbol siempre produce el mismo mapa, por lo que las reproducciones son comparables entre sesiones. Ningún dato de sesión sale de tu máquina — completamente local.