961fc90313
- Add clap-based CLI with comprehensive help - Add TOML config support (~/.config/claude-chill.toml) - Add key_parser for user-friendly key bindings ([ctrl][shift][j]) - Change default lookback key to Ctrl+Shift+J - Remove unused modules (analyzer, output_processor, script_parser) - Add MIT LICENSE file - Add disclaimer to README Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
claude-chill
A PTY proxy that tames Claude Code's massive terminal updates.
The Problem
Claude Code uses synchronized output to update the terminal atomically. It wraps output in sync markers (\x1b[?2026h ... \x1b[?2026l) so the terminal renders everything at once without flicker.
The problem: Claude Code sends entire screen redraws in these sync blocks - often thousands of lines. Your terminal receives a 5000-line atomic update when only 20 lines are visible. This causes lag, flicker, and makes scrollback useless since each update clears history.
The Solution
claude-chill sits between your terminal and Claude Code:
- Intercepts sync blocks - Catches those massive atomic updates
- Truncates output - Sends only the last N lines (default: 100) to your terminal
- Preserves history - Stores the full content in a buffer
- Enables lookback - Press a key to dump the buffer, then scroll up
Installation
cargo install --path crates/claude-chill
Usage
claude-chill claude
claude-chill -- claude --verbose # Use -- for command flags
claude-chill -l 50 -- claude # Set max lines to 50
Lookback
Press Ctrl+Shift+J to dump the history buffer to terminal. Scroll up to see it. The next update from Claude will resume normal display.
Configuration
Create ~/.config/claude-chill.toml:
max_lines = 100 # Lines shown per sync block
history_lines = 100000 # Lines stored for lookback
lookback_key = "[ctrl][shift][j]"
Key Format
[modifier][key] - Examples: [f12], [ctrl][g], [ctrl][shift][j]
Modifiers: [ctrl], [shift], [alt]
Keys: [a]-[z], [f1]-[f12], [pageup], [pagedown], [home], [end], [enter], [tab], [space], [esc]
Disclaimer
This tool was developed for personal convenience on Debian Linux. It works for me, but it hasn't been extensively tested across different terminals, operating systems, or edge cases. Don't use it to send anyone to space, perform surgery, or run critical infrastructure. If it breaks, you get to keep both pieces.
License
MIT