Mindwalk: o Criador de Air Agora Te Deixa Ver Por Onde Andou teu Agente
Se você escreve Go há mais de alguns meses, provavelmente já rodou air sem pensar duas vezes — é a ferramenta de live-reload que metade da comunidade Go usa durante o desenvolvimento. A pessoa por trás dela, cosmtrek, acaba de lançar algo em uma pista completamente distinta: uma ferramenta para ver o que seu coding agent realmente fez com seu repo.
Chamase Mindwalk, e o pitch é refrescantemente focado. Não gerencia seus agentes, não adiciona hooks ao seu workflow, não vive no seu terminal como uma barra de status. Lê um session log depois dos fatos e te mostra a forma do que aconteceu.
O problema que resolve
Um session log te diz o que o agente fez — quais tool calls, quais arquivos, em que ordem. Não te diz como entendeu a tarefa. Tratou como relevantes as partes corretas do repo? Andou dando voltas antes de encontrar o problema real? Seu rastro coincidiu com o escopo que você tinha em mente, ou tocou três vezes mais superfície do que precisava?
Ler um JSONL bruto linha por linha não responde nada disso. Você teria que reconstruir a forma da sessão na sua cabeça.
A ideia: um mapa noturno
Mindwalk desenha seu repositório como um mapa escuro e reproduz a sessão como luz se movendo sobre ele. Onde o agente procurou, leu ou editou, essa parte do mapa se acende. O resto fica escuro. Cada arquivo guarda seu estado de toque mais profundo — visto (verde musgo), lido (branco lua), editado (âmbar quente) — então você tem de uma olhada a forma real de para onde foi a atenção do agente, não apenas uma lista de paths.
O HUD adiciona uma camada de informação em cima: taxa de erro, quais arquivos sofreram mudanças repetidas, edições que passaram depois do último verify. Um timeline marca compactações de contexto, lançamentos de subagentes e turnos do usuário como pontos de click-to-jump, e um playback deck deixa você scrubear a sessão sobre um histograma agrupado — a observação fica em tons frios, a mutação brilha em quente, então as fases de edição saltam à vista sem ler uma única linha de log.
Está construído exatamente para isso: um único binário em Go que lê session logs de Claude Code e Codex, tudo local — nenhum dado de sessão sai da sua máquina.
Colocando para rodar
curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
mindwalk
Sem argumentos, escaneia ~/.claude/projects e ~/.codex/sessions, levanta um server local e abre seu navegador. Você também pode apontá-lo para uma sessão específica (mindwalk open <session.jsonl>), ou gerar os dados subjacentes você mesmo: mindwalk build <repo> escreve o layout do repo como JSON, mindwalk trace <session> escreve o stream de eventos normalizado. O instalador verifica contra um arquivo de checksum, então você não está pipando um binário às cegas para seu PATH.
Por baixo, o design está deliberadamente separado em duas peças: um trace (o session log normalizado em eventos de toque por arquivo, um adapter por formato de agente) e um citymap (um layout determinístico do seu repo — a mesma árvore sempre produz o mesmo mapa, então as sessões são comparáveis entre si). Um server local em Go junta as duas peças e serve um frontend em React/Three.js. Separação limpa, fácil ver onde você adicionaria suporte para um terceiro formato de agente se quisesse.
Por que isso é uma forma distinta do que já cobrimos
Já escrevemos sobre algumas ferramentas no espaço de “o que está fazendo meu agente” — o dashboard local de AgentsView, a barra de status ao vivo de Claude HUD, a plataforma de observabilidade de Laminar. Todas estão construídas para um momento distinto: querem que você esteja olhando enquanto o agente trabalha, ou que você compare custos e traces entre muitas corridas.
Mindwalk não está competindo aí. É uma ferramenta post-mortem. Você a roda quando a sessão já terminou, da mesma forma que abriria o diff de um PR em vez de olhar por cima do ombro enquanto alguém digita. É um caso de uso distinto — menos “meu agente está travado agora?”, mais “essa sessão se ganhou minha confiança, e por onde devo começar a olhar antes de mergear seu trabalho?”.
O limite honesto
Um replay te mostra por onde andou o agente, não se o que fez lá estava certo. Ver que um agente tocou três arquivos te diz onde olhar — não te diz se as edições foram corretas. E é justo apontar que o README ainda não diz nada sobre como o mapa se comporta em um monorepo muito grande, nem se você pode comparar duas corridas da mesma tarefa entre si. Esse é o feature óbvio que falta para qualquer um que queira usar isso para avaliar a qualidade do agente ao longo do tempo, não apenas inspecionar uma sessão isolada.
Vale a pena mencionar que um comentário na thread de Show HN veio de alguém construindo sua própria ferramenta de memória de agente para um coding agent distinto, e sua leitura foi que o valor não está na visualização em si — está em poder saber rápido se uma mudança que você fez na configuração do seu agente realmente o tornou mais inteligente ou não. Esse é provavelmente o caso de uso mais duradouro do que o que sugerem as capturas de tela da demo.
Instalar ou não?
Se você roda sessões de Claude Code ou Codex regularmente e alguma vez terminou uma tarefa se perguntando o que exatamente ele fez para chegar lá — isso é uma instalação de cinco minutos que responde essa pergunta visualmente em vez de scrollando um transcript. É MIT-licensed, é completamente local, e o caminho de instalação é um único binário verificado.
Alguém já testou em um repo grande? Me interessa saber se o mapa fica ilegível a partir de certo tamanho, ou se aguenta bem.