Exportez vos sessions de chat Claude Code avec cctrace

cctrace est un outil en ligne de commande open-source innovant conçu pour simplifier l'exportation de vos sessions de chat depuis Claude Code. Pour les développeurs, les data scientists et les passionnés d'IA, disposer d'un historique complet des interactions d'IA, y compris le raisonnement interne et l'utilisation des outils, est inestimable. cctrace offre une solution robuste, garantissant que toutes les données critiques sont capturées et rendues accessibles.

Qu'est-ce que cctrace ?

cctrace, abréviation de "Claude Code Trace", est un utilitaire basé sur Python qui permet aux utilisateurs d'exporter leurs sessions de chat Claude Code dans différents formats tels que Markdown, XML et JSONL brut. Il est conçu pour être convivial, offrant à la fois une intégration simple via une commande slash directement dans Claude Code et des options de ligne de commande flexibles pour une personnalisation avancée.

Fonctionnalités clés :

• Détection automatique de session : Identifie intelligemment votre session Claude Code actuelle, même avec plusieurs sessions concurrentes, en renvoyant l'ID de session, la transcription et toutes les métadonnées.
• Capture complète des données : Exporte tous les messages, les blocs de "réflexion" (raisonnement interne), l'utilisation des outils avec leurs entrées et sorties, et des métadonnées complètes.
• Formats de sortie multiples : Génère des fichiers Markdown lisibles par l'homme pour une révision facile, des fichiers XML structurés pour le traitement programmatique et des fichiers JSONL bruts pour une analyse détaillée.
• Intégration via commande slash : Exportez directement depuis votre session Claude Code à l'aide d'une simple commande /export.
• Archives horodatées : Chaque exportation est enregistrée dans un répertoire unique et horodaté pour une organisation facile.
• Copie automatique vers le répertoire de travail : Copie optionnellement les exportations directement dans votre répertoire de projet actuel, simplifiant le contrôle de version et l'accès.

Pourquoi utiliser cctrace ?

Dans l'environnement de développement d'IA actuel, l'analyse et le suivi des interactions d'IA sont cruciaux. Que vous déboguiez des invites, documentiez le comportement de l'IA ou partagiez des informations avec une équipe, cctrace vous assure de disposer d'un enregistrement complet et bien structuré. Sa capacité à capturer le raisonnement interne détaillé et les appels aux outils offre un niveau de transparence sans précédent sur la façon dont Claude Code opère pendant vos sessions.

Démarrer avec cctrace

Prérequis :

• Python 3.6 ou plus récent
• Claude Code fonctionnant sur Linux ou WSL
• Accès au répertoire ~/.claude/projects/

Installation rapide :

1. Cloner le dépôt :

   git clone https://github.com/jimmc414/cctrace.git
   cd cctrace
   

2. Exécuter l'installateur :

   chmod +x install.sh
   ./install.sh
   

Utilisation :

Via la commande slash de Claude Code (Recommandé) :

Tapez simplement /export ou /user:export dans votre session Claude Code. L'outil détectera et exportera automatiquement votre session actuelle, affichant un résumé directement dans Claude Code.

Via la ligne de commande :

Pour plus de contrôle, vous pouvez exécuter directement le script export_claude_session.py :

• Exporter la session active actuelle :

  python3 ~/claude_sessions/export_claude_session.py
  

• Exporter une session spécifique par ID :

  python3 ~/claude_sessions/export_claude_session.py --session-id <votre-ID-de-session>
  

• Spécifier le format de sortie ou le répertoire :

  python3 ~/claude_sessions/export_claude_session.py --format xml --output-dir /chemin/vers/mes/exportations
  

Contenu des exportations expliqué

Chaque exportation crée un répertoire horodaté contenant divers fichiers :

• session_info.json : Métadonnées complètes de la session, y compris l'ID de session, le répertoire du projet, les horodatages et l'utilisation du modèle.
• conversation_full.md : Un fichier Markdown lisible par l'homme de la conversation complète, avec des sections repliables pour les blocs de pensée et l'utilisation des outils.
• conversation_full.xml : Un fichier XML entièrement étiqueté préservant toutes les métadonnées, la hiérarchie des messages et les informations détaillées sur l'exécution des outils, idéal pour le traitement automatisé.
• raw_messages.jsonl : Les données JSONL originales et non modifiées de Claude Code, parfaites pour une analyse programmatique approfondie.
• summary.txt : Un bref aperçu en texte brut de la session et des détails de l'exportation.

cctrace est un outil essentiel pour quiconque travaille avec Claude Code, offrant les moyens de gérer, analyser et partager de manière approfondie les données de conversation de l'IA. Sa nature open-source encourage les contributions de la communauté et assure une amélioration continue.