Claude Chill : corriger le scintillement de Claude Code dans le terminal

• Claude Chill est un outil proxy PTY qui atténue les problèmes de latence et de scintillement causés lorsque Claude Code redessine de façon répétée l’intégralité du terminal
• Il intercepte les sorties synchronisées (sync blocks) utilisées par Claude Code et, grâce à un rendu basé sur VT100, ne met à jour que les parties modifiées de l’écran
• Il conserve un tampon d’historique pour permettre le scrollback, avec un mode lookback accessible via Ctrl+6 pour consulter l’historique complet des sorties
• Il propose une fonction auto-lookback qui exporte automatiquement l’historique après une certaine période d’inactivité
• Il fonctionne sous Linux et macOS et constitue une solution légère pour améliorer les performances et la lisibilité du terminal

---

Aperçu

• Claude Chill est un programme proxy PTY conçu pour résoudre les problèmes de sortie terminal de Claude Code
  • Claude Code encapsule toute la sortie dans des blocs synchronisés pour effectuer un rendu en une seule fois, mais ce processus provoque des rafraîchissements plein écran de plusieurs milliers de lignes
  • Cela entraîne des problèmes de latence, scintillement et perte du scrollback
• Claude Chill se place entre le terminal et Claude Code pour n’appliquer que les différences de sortie et conserver un tampon d’historique

Fonctionnalités principales

• Interception des blocs sync : détecte et traite les gros blocs synchronisés envoyés par Claude Code
• Rendu basé sur VT : utilise un émulateur VT100 pour suivre l’état de l’écran et n’afficher que les parties modifiées
• Conservation de l’historique et mode lookback : stocke la sortie dans un tampon pour permettre la consultation des anciens journaux
  • Entrée dans le mode lookback avec la touche Ctrl+6
  • Met temporairement en pause la sortie de Claude et affiche l’historique complet dans le terminal
  • On peut quitter en appuyant à nouveau sur la touche ou avec Ctrl+C
• Auto-lookback : si aucune saisie n’est détectée pendant un certain temps (15 secondes par défaut), l’historique est exporté automatiquement
  • Peut être désactivé avec l’option -a 0
  • Lors d’un export automatique, l’écran peut scintiller brièvement

Installation et utilisation

• Installation :

  cargo install --path crates/claude-chill  
  

• Exemples d’exécution :
  • Exécution de base : claude-chill claude
  • Passage d’arguments : claude-chill -- claude --verbose
  • Définir la taille de l’historique : claude-chill -H 50000 claude
  • Désactiver l’auto-lookback : claude-chill -a 0 claude
• Options principales :
  • -H, --history : nombre maximal de lignes d’historique (100000 par défaut)
  • -k, --lookback-key : touche de bascule du mode lookback
  • -a, --auto-lookback-timeout : délai d’attente avant l’auto-lookback (ms)

Fichier de configuration

• Emplacement :
  • Linux : ~/.config/claude-chill.toml
  • macOS : ~/Library/Application Support/claude-chill.toml
• Principales entrées :
  • history_lines : nombre maximal de lignes d’historique
  • lookback_key : touche de bascule du mode lookback
  • refresh_rate : FPS de rendu
  • auto_lookback_timeout_ms : délai de l’auto-lookback

Protocole clavier et configuration des touches

• Bascule automatiquement de mode dans les terminaux prenant en charge le Kitty Keyboard Protocol (Kitty, Ghostty, WezTerm, etc.)
  • Si Claude Code active le mode Kitty, Claude Chill reconnaît automatiquement cet encodage lui aussi
• Format des touches : [modifier][key]
  • Exemples : [f12], [ctrl][g], [ctrl][shift][j]
• La touche par défaut Ctrl+6 envoie ASCII 0x1E et n’entre en conflit avec presque aucun terminal
  • Sur macOS, Ctrl+Shift+6 (Ctrl+^) produit le même comportement

Fonctionnement

• Claude Chill crée un terminal virtuel (PTY) et lance Claude Code comme processus enfant
• Architecture proxy d’entrée/sortie :

  Terminal ⇄ claude-chill ⇄ Claude Code  
  

• Principales étapes de traitement :
  • Entrée : transmise à Claude, seule la touche lookback est interceptée
  • Sortie : détection des blocs synchronisés, la sortie asynchrone est transmise telle quelle
  • Suivi de l’état de l’écran via l’émulation VT
  • Rendu des seules différences après comparaison avec l’état précédent
  • Conservation du tampon d’historique et prise en charge du mode lookback
  • Transmission à Claude des signaux comme SIGWINCH, SIGINT, SIGTERM

Points d’attention

• Outil développé pour un usage personnel, sans campagne de tests étendue
• Fonctionnement vérifié sur Linux et macOS
• Son utilisation n’est pas recommandée sur des systèmes ou infrastructures critiques
• Licence MIT