O que é mindwalk?
O mindwalk lê os logs de sessão que os agentes de código deixam no disco e os reproduz sobre um mapa da base de código. Os arquivos brilham à medida que o agente os pesquisa, lê e edita, então você vê de relance onde ele explorou, até onde as mudanças se espalharam e se ele conferiu o próprio trabalho. Uma linha do tempo marca compactações de contexto, lançamentos de subagentes e turnos do usuário, e o trace de cada subagente pode ser reproduzido separadamente.
Ele também tem uma etapa opcional de avaliação: a sua própria CLI `claude` ou `codex` redige critérios de sucesso a partir do seu pedido e pontua a sessão em quatro dimensões fixas (exploração, escopo, desvios, verificação), com cada constatação ligada a eventos da linha do tempo.
É um único binário Go com front-end em React e Three.js, sob licença MIT, de Ricko Yu, autor do Air, ferramenta de live reload para Go. A v0.5.0 saiu em 7 de agosto de 2026, o último commit entrou em 10 de agosto, e o repositório tinha cerca de 1.400 estrelas na última verificação.
mindwalk vale a pena?
O mindwalk responde a uma pergunta que os logs JSONL brutos não respondem: o que o agente considerou relevante. Cada arquivo guarda o contato mais profundo que teve (visto, lido ou editado), arquivos apagados continuam visíveis em wireframe, e o histograma de reprodução pinta a observação em cores frias e a modificação em cores quentes, então um agente que editou antes de ler fica evidente na hora. Uma faixa de revisão resume em uma linha a taxa de erros, os arquivos mexidos repetidamente e as edições depois da última verificação, que é a parte que um revisor vai usar todo dia.
O desenho de privacidade é cuidadoso. A visualização é totalmente local e não envia nada; o instalador confere o binário com checksums publicados. A avaliação é opcional e roda a sua própria CLI sem ferramentas, sem servidores MCP e sem configurações, enviando só as mensagens do usuário daquela sessão, caminhos de arquivos e resumos de uma linha dos eventos. Os veredictos são consolidados mecanicamente a partir da gravidade das constatações, em vez de ficarem a cargo do modelo, e os critérios são reutilizados quando o texto da tarefa não mudou, então pontuações repetidas continuam comparáveis.
A cobertura é a limitação. Ele lê logs do Claude Code, do Codex e do pi; o suporte a OpenCode, Crush e Antigravity existe só como pedidos e pull requests abertos, incluindo uma série de nove partes para o Crush aberta em 9 de setembro e não incorporada na última verificação. Com 17 issues e pull requests abertos, cinco versões entre 11 de julho e 7 de agosto e nada incorporado desde 10 de agosto, é uma v0.5 que funciona, não um produto mantido.
Ele fica ao lado do ccusage, não no lugar dele: o ccusage diz quanto uma sessão custou, o mindwalk mostra o que ela fez. Nenhum dos dois tem visão de equipe, e o mindwalk só vê sessões que ainda estão no disco, então a limpeza padrão de transcrições de 30 dias do Claude Code limita até onde ele consegue voltar.
Onde ele se destaca
Um tech lead revisando pull requests abertos pelo Claude Code
Conferir se as mudanças do agente ficaram dentro do escopo do ticket
Abra a sessão com `mindwalk open <session.jsonl>` e percorra a linha do tempo; âmbar fora dos diretórios esperados é o sinal para ler o diff com atenção. Gratuito, e leva um minuto por sessão.
Um desenvolvedor ajustando o CLAUDE.md ou uma skill
Ver se as novas instruções mudam o quanto o agente explora antes de editar
Rode `mindwalk analyze` em sessões de antes e de depois da mudança e compare as dimensões de exploração e verificação. Cada análise faz até duas chamadas no seu próprio plano Claude ou Codex.
Um gerente de engenharia conduzindo um piloto de agentes com cinco desenvolvedores
Mostrar à equipe exemplos concretos de sessões de agente boas e ruins
Exporte uma reprodução para .webm pelo menu do painel, gravada no navegador, e compartilhe em uma retrospectiva. Não há servidor compartilhado, então cada desenvolvedor exporta da própria máquina.
Antes de decidir
- Configuração
- `curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh` instala em ~/.local/bin depois de conferir o checksum; os arquivos para Windows estão no GitHub Releases. Rodar `mindwalk` varre ~/.claude/projects, ~/.codex/sessions e ~/.pi/agent/sessions e abre um navegador.
- Integrações
- Adaptadores de sessão para Claude Code, Codex e pi; a CLI `claude` ou `codex` como juiz da avaliação; exportações em JSON do trace, do mapa do repositório e dos relatórios, com schemas em schema/. Usuários de Nix podem instalá-lo pelo flake numtide/llm-agents.
- Dados e privacidade
- A visualização é local e não envia nada. A avaliação, só quando você a roda, envia as mensagens do usuário, os caminhos de arquivos e os resumos de eventos de uma sessão ao modelo por trás da sua própria CLI; os relatórios ficam em cache em ~/.mindwalk/reports. Licença MIT.
- Custo em escala
- Gratuito; a avaliação custa até duas chamadas de modelo por sessão no seu plano existente. Sem edição hospedada ou paga.
- Limites
- Só três formatos de agente; nenhuma mudança incorporada desde agosto de 2026; roda em uma porta local aleatória por máquina, sem visão multiusuário; o histórico se limita aos logs que o agente ainda guarda.
O que é bom
- Visualização totalmente local; nada é enviado, a menos que você avalie
- Traces de subagentes reproduzíveis no mesmo mapa
- Avaliação ligada a evidências, com veredictos mecânicos
- Um único binário Go com instalador verificado por checksum
O que não é
- Hoje só lê logs do Claude Code, do Codex e do pi
- Nenhuma mudança incorporada desde 10 de agosto de 2026
- Sem visão de equipe ou de várias máquinas
- A avaliação gasta tokens do seu próprio plano
Ideal para
Desenvolvedores e tech leads que revisam o trabalho de agentes de código e querem ver o rastro do agente antes de ler o diff.
Alternativas ao mindwalk
mindwalk: perguntas frequentes
- mindwalk vale a pena?
- Ver por onde um agente andou no seu repositório leva segundos com o mindwalk, mas é uma ferramenta jovem cujo desenvolvimento está parado desde agosto. Damos nota 3.6 de 5.
- Quanto custa mindwalk?
- Gratuito e de código aberto (MIT). A avaliação de sessões usa o seu plano Claude ou Codex existente.
- Quais são as desvantagens de mindwalk?
- Hoje só lê logs do Claude Code, do Codex e do pi; nenhuma mudança incorporada desde 10 de agosto de 2026; sem visão de equipe ou de várias máquinas; a avaliação gasta tokens do seu próprio plano.
- Para quem mindwalk é indicado?
- Desenvolvedores e tech leads que revisam o trabalho de agentes de código e querem ver o rastro do agente antes de ler o diff.
- Quanto custa mindwalk para uma equipe ou em produção?
- Gratuito; a avaliação custa até duas chamadas de modelo por sessão no seu plano existente. Sem edição hospedada ou paga.
- mindwalk é seguro para dados da empresa?
- A visualização é local e não envia nada. A avaliação, só quando você a roda, envia as mensagens do usuário, os caminhos de arquivos e os resumos de eventos de uma sessão ao modelo por trás da sua própria CLI; os relatórios ficam em cache em ~/.mindwalk/reports. Licença MIT.
- Quais são as melhores alternativas ao mindwalk?
- As alternativas mais próximas que analisamos são ccusage, claude-mem e Graphify.
Respostas verificadas em 26 de out. de 2026.