companion-capture : L'outil sauvegarde les bulles de parole éphémères de Claude Code

Ce que fait companion-capture

Si vous utilisez Claude Code dans le terminal, vous avez probablement remarqué le personnage compagnon qui apparaît avec des bulles de dialogue pendant que vous travaillez. Ces messages sont éphémères—l'interface TUI se redessine et ils disparaissent. Certains contiennent des observations utiles sur votre code, des avertissements sur des bugs ou des commentaires amusants. companion-capture surveille la sortie du terminal, extrait ces messages de bulles et les enregistre dans des fichiers markdown (et optionnellement dans SQLite pour la recherche).

Comment cela fonctionne

• Un wrapper shell lance Claude Code via script -q -F pour capturer la sortie brute du terminal
• Un analyseur Python exécute un tampon d'écran VT100 (pas un nettoyage ANSI—un véritable suivi de la position du curseur) pour déterminer où le texte est réellement affiché
• Les messages nécessitent deux analyses consécutives avant d'être écrits, pour éviter d'obtenir des données partiellement rendues
• Un crochet PostToolUse expose les nouvelles captures à Claude pendant la session, afin qu'il puisse voir ce que le compagnon a dit

Fonctionnalités

• Aucune dépendance d'exécution (uniquement la bibliothèque standard Python)
• Recherche en texte intégral dans les captures (companion-capture search "auth bug")
• Contrôles de confidentialité—exclusion de motifs, listes de blocage de projets, rétroaction rétroactive
• Rappel contextuel optionnel qui transmet automatiquement les captures récentes à Claude
• companion-capture doctor pour vérifier l'état de l'ensemble de la configuration
• Plus de 400 cas de test pytest

Ce que le développeur a découvert en l'utilisant

Le compagnon détecte réellement des choses. Il a signalé un script de migration qui n'avait aucune couverture de test. Il a remarqué une condition de concurrence dans une configuration multi-session. La plupart du temps, ce sont des ambiances et des réactions, mais toutes les quelques sessions, il livre quelque chose qui mérite vraiment d'être relu.

Limitations actuelles

MacOS + Claude Code uniquement pour le moment. Aucune dépendance externe, licence MIT.

GitHub : github.com/jaywadhwa/companion-capture