Mindwalk - un outil de visualisation qui rejoue les sessions d’agents de code sur une carte 3D de la base de code

• Les journaux de session enregistrent ce que l’agent a fait, mais pas comment il a compris la tâche (quelles zones il a jugées pertinentes, où il a exploré, si cela correspondait au périmètre du travail), et cela ne se voit pas en lisant le JSONL brut
• Le dépôt est dessiné comme une carte nocturne : les emplacements recherchés/lus/modifiés par l’agent brillent, tandis que le reste reste dans l’obscurité, afin de visualiser d’un coup d’œil sa compréhension du travail
• Un binaire Go autonome lit les journaux de session de Claude Code et Codex, et tout le processus de visualisation fonctionne entièrement en local
• Les vues Tree/Terrain représentent le dépôt sous forme d’arbre radial ou de plan en treemap ; plus un fichier est profond et souvent touché, plus son intensité lumineuse augmente
• Le statut de touch de chaque fichier est différencié par couleur — seen (vert), read (bleu), edited (ambre), unvisited (sombre)
  • Les fichiers touchés par la session mais disparus du dépôt restent sous forme de fantômes filaires
  • Le HUD regroupe des signaux de friction comme le taux d’erreur, les fichiers avec churn, ou les modifications depuis le dernier verify
• Le Playback deck permet de scruber/lire la session au-dessus d’un histogramme découpé en buckets ; les observations (recherche/lecture/exécution) sont placées dans des tons froids et les transformations (modification/verify) dans des tons chauds, ce qui fait ressortir les phases d’édition
  • Prise en charge de l’export complet de la lecture en .webm côté client
• Les Timeline marks indiquent la compression de contexte (◇), l’exécution de sous-agents (○) et les tours utilisateur (›), avec possibilité de cliquer pour sauter à ce point
• Les Agent lenses permettent de rejouer sur la même carte les traces des sous-agents exécutés par la session, puis de revenir à la trace principale
• La fonction d’évaluation de session demande au CLI local de juger l’exploration, le périmètre, l’errance et la vérification ; toutes les constatations sont ancrées à des événements cliquables dans la timeline
  • Uniquement lors de l’exécution de l’évaluation, un résumé de session (formulation des messages, chemins de fichiers, résumé d’événement sur une ligne) est envoyé au modèle derrière les CLI claude/codex du compte utilisateur ; aucune autre session n’est incluse
• En interne, trois artefacts sont volontairement séparés : trace (flux normalisé d’événements de touch sur les fichiers), citymap (layout déterministe du dépôt), report (constatations fondées sur des preuves du juge LLM)
  • Un serveur Go local les assemble et les sert à un frontend React/Three.js
• Licence MIT