claude-replay — Sessions Claude Code en replays HTML interactifs¶

Resume¶

claude-replay (591 stars, MIT, Node.js, zero dependance) convertit les sessions Claude Code (JSONL dans ~/.claude/projects/) en fichiers HTML autonomes avec playback interactif. Affiche les tours de conversation, tool calls, thinking blocks, timestamps. Supporte aussi Cursor, Codex CLI, Gemini CLI et OpenCode (auto-detection du format). Sortie : un seul fichier HTML compresse, partageable par email ou hebergeable sans infra. Max 20 sessions concatenees.

Analyse critique¶

L'outil resout un vrai probleme : les sessions Claude Code sont des JSONL illisibles. Les replays HTML permettent de les parcourir visuellement, de comprendre les decisions de l'agent, et de les partager. Le support multi-agents (pas juste Claude Code) est un bon choix — on utilise Claude Code + Codex + OpenCode dans notre workflow.

Limites : 591 stars et 150 commits, c'est modeste. Pas d'extraction de metriques (duree totale, tokens consommes, nombre de tool calls, taux d'erreur) — juste du rendu visuel. Pour un usage serieux en retrospective, on voudrait aussi des stats, pas juste un replay.

Pertinence ProbatioVault¶

Impact faible mais utile pour deux cas :

Retrospectives (step 10) : aujourd'hui le REX est redige depuis les artefacts et les metriques. Un replay visuel de la session Ringbearer permettrait de revoir le deroulement reel — les hesitations de l'agent, les retries, les changements de direction. C'est le type de contexte que le terminal.log capture en texte brut mais que le replay rendrait navigable.

Partage avec tiers : si on devait montrer le deroulement d'une story a un auditeur ou un client, un HTML autonome est plus parlant qu'un JSONL ou un terminal.log de 10000 lignes.

Ce qu'on a deja : data/sessions/PD-XXX-session.jsonl + terminal.log par Ringbearer. claude-replay pourrait consommer directement ces fichiers pour generer des replays archivables dans le dossier epic de la story.