Claude Chill: टर्मिनल में Claude Code की flickering समस्या को ठीक करना

• Claude Chill एक PTY proxy tool है जो Claude Code द्वारा पूरे टर्मिनल को बार-बार redraw करने पर होने वाली latency और flickering समस्याओं को कम करता है
• यह Claude Code द्वारा उपयोग किए जाने वाले synchronized output (sync blocks) को intercept करता है और VT100-आधारित rendering के जरिए स्क्रीन के केवल बदले हुए हिस्सों को ही update करता है
• यह history buffer बनाए रखता है, जिससे scrollback संभव होता है, और Ctrl+6 कुंजी से ‘lookback mode’ में जाकर पूरा output history देखा जा सकता है
• एक निश्चित समय तक input न होने पर history को अपने-आप dump करने वाला auto-lookback फीचर भी देता है
• Linux और macOS पर काम करता है, और terminal performance व readability को बेहतर बनाने वाला हल्का solution है

---

अवलोकन

• Claude Chill एक PTY proxy program है, जिसे Claude Code के terminal output से जुड़ी समस्याओं को हल करने के लिए बनाया गया है
  • Claude Code पूरे output को sync blocks में wrap करके एक साथ render करता है, लेकिन इस प्रक्रिया में हजारों लाइनों का full-screen refresh हो सकता है
  • इसके कारण latency, flickering, और scrollback loss जैसी समस्याएँ पैदा होती हैं
• Claude Chill टर्मिनल और Claude Code के बीच बैठकर सिर्फ output diff लागू करता है और history buffer बनाए रखता है

मुख्य फीचर

• Sync block interception: Claude Code द्वारा भेजे गए बड़े synchronized blocks को detect और process करता है
• VT-आधारित rendering: VT100 emulator का उपयोग करके screen state को track करता है और केवल बदले हुए हिस्से output करता है
• History retention और lookback mode: output को buffer में save रखता है ताकि पुराने logs देखे जा सकें
  • Ctrl+6 कुंजी से lookback mode में प्रवेश
  • Claude का output अस्थायी रूप से रोककर पूरा history टर्मिनल में दिखाता है
  • कुंजी दोबारा दबाकर या Ctrl+C से बाहर निकला जा सकता है
• Auto-lookback: एक निश्चित समय तक (डिफ़ॉल्ट 15 सेकंड) input न होने पर history अपने-आप dump हो जाता है
  • -a 0 option से इसे disable किया जा सकता है
  • auto dump के समय स्क्रीन थोड़ी देर के लिए flicker कर सकती है

इंस्टॉलेशन और उपयोग

• इंस्टॉल:

  cargo install --path crates/claude-chill  
  

• चलाने के उदाहरण:
  • सामान्य रन: claude-chill claude
  • arguments के साथ: claude-chill -- claude --verbose
  • history size सेट करना: claude-chill -H 50000 claude
  • auto-lookback disable करना: claude-chill -a 0 claude
• मुख्य options:
  • -H, --history: history की अधिकतम lines (डिफ़ॉल्ट 100000)
  • -k, --lookback-key: lookback mode toggle key
  • -a, --auto-lookback-timeout: auto-lookback wait time (ms)

कॉन्फ़िगरेशन फ़ाइल

• स्थान:
  • Linux: ~/.config/claude-chill.toml
  • macOS: ~/Library/Application Support/claude-chill.toml
• मुख्य items:
  • history_lines: history की अधिकतम lines
  • lookback_key: lookback mode toggle key
  • refresh_rate: rendering FPS
  • auto_lookback_timeout_ms: auto-lookback समय

Keyboard protocol और key settings

• Kitty Keyboard Protocol को support करने वाले टर्मिनल (Kitty, Ghostty, WezTerm आदि) में mode अपने-आप switch हो जाता है
  • जब Claude Code Kitty mode को activate करता है, Claude Chill भी उसी encoding को अपने-आप पहचान लेता है
• key format: [modifier][key]
  • उदाहरण: [f12], [ctrl][g], [ctrl][shift][j]
• डिफ़ॉल्ट key Ctrl+6 ASCII 0x1E भेजती है, और यह ज़्यादातर terminals से टकराती नहीं है
  • macOS में Ctrl+Shift+6 (Ctrl+^) वही काम करता है

काम करने का तरीका

• Claude Chill एक virtual terminal (PTY) बनाता है और Claude Code को child process के रूप में चलाता है
• I/O proxy architecture:

  Terminal ⇄ claude-chill ⇄ Claude Code  
  

• मुख्य processing steps:
  • input: Claude तक forward किया जाता है, केवल lookback key को block किया जाता है
  • output: sync blocks को detect किया जाता है और asynchronous output को वैसे ही pass through किया जाता है
  • VT emulation के जरिए screen state track की जाती है
  • पिछली state से तुलना करके सिर्फ diff render किया जाता है
  • history buffer बनाए रखा जाता है और lookback mode support किया जाता है
  • SIGWINCH, SIGINT, SIGTERM जैसे signals Claude तक forward किए जाते हैं

ध्यान देने योग्य बातें

• यह एक निजी सुविधा के लिए बनाया गया tool है, इसलिए इस पर व्यापक testing नहीं की गई है
• Linux और macOS पर काम करना verified है
• महत्वपूर्ण system या infrastructure environments में इसके उपयोग की सिफारिश नहीं की जाती
• MIT License