Introduction
Claude-replay est un outil communautaire qui permet de convertir les journaux de sessions Claude Code en fichiers HTML interactifs et partageables. Cet outil répond au besoin de partager facilement les sessions de développement, qui étaient auparavant difficiles à partager en raison de l'encombrement des enregistrements d'écran et de la difficulté de navigation dans les transcripts.
Contexte Technique
Claude Code stocke les transcripts complets des conversations sous forme de fichiers JSONL sur disque, dans le répertoire ~/.claude/projects/. Ces fichiers contiennent chaque message utilisateur, chaque réponse de l'assistant, chaque appel d'outil, chaque résultat d'outil et chaque bloc de réflexion, avec des horodatages. Claude-replay convertit ces fichiers en replays visuels qui ressemblent à une session de terminal Claude Code, adaptés pour les billets de blog, les démonstrations et la documentation.
L'outil offre plusieurs fonctionnalités, notamment la sortie HTML autonome sans dépendances, la lecture interactive avec contrôle de vitesse, le repli/dépli des appels d'outils et des blocs de réflexion, ainsi que la possibilité de créer des signets et des chapitres. De plus, il propose une rédaction de secrets avant l'exportation, plusieurs thèmes de couleur et un défilement de style terminal de bas en haut.
Analyse et Implications
Claude-replay est utile pour diverses applications, telles que les billets de blog pour montrer des sessions de développement assistées par l'IA de manière interactive, la documentation pour intégrer des sessions de débogage ou des démonstrations de code, les démonstrations pour partager des sessions reproductibles sans vidéo, les rapports de bogue pour joindre un replay au lieu de longs journaux, et l'enseignement pour passer étape par étape dans la raison et l'utilisation des outils par l'IA.
La sécurité est également prise en compte, car claude-replay scanne automatiquement le texte intégré pour les modèles de secrets courants et les remplace par [REDACTED] avant de les écrire dans le fichier HTML de sortie. Cependant, il est important de noter que la rédaction basée sur des modèles est un filet de sécurité qui ne peut pas capturer tous les formats de secrets possibles, et il est donc recommandé de vérifier le fichier HTML généré avant de le partager publiquement.
Perspective
Claude-replay offre une solution pratique pour partager et revoir les sessions de développement assistées par l'IA. Les utilisateurs peuvent personnaliser l'apparence des replays en utilisant différents thèmes ou en créant leurs propres thèmes à l'aide de fichiers JSON. De plus, l'outil est conçu pour être léger et ne nécessite pas de dépendances externes, ce qui le rend facile à intégrer dans divers contextes.
À l'avenir, il sera intéressant de suivre les mises à jour et les améliorations apportées à claude-replay, notamment en termes de fonctionnalités et de sécurité. L'outil a le potentiel de devenir un outil essentiel pour les développeurs qui travaillent avec l'IA et qui ont besoin de partager et de revoir leurs sessions de développement de manière efficace.
