cc — Claude Code scroll fix

When using Claude Code, the terminal snaps to the bottom every time Claude produces output — even if you're scrolled up reading history. This is a Claude Code issue (not a terminal issue). It happens in iTerm2, Ghostty, Kitty, and every other terminal because Claude's TUI framework actively repositions the cursor on every redraw.

cc wraps Claude Code in tmux, which decouples your scroll position from the application's cursor. Scroll up to read, Claude keeps writing underneath. Done reading? Press q to resume live output.

Install

git clone https://github.com/rsmith/cc.git
cd cc
./install.sh

Usage

cc                              # launch claude code
cc --dangerously-skip-permissions  # pass any claude args through

How it works

• cc launches Claude Code inside a tmux session
• Scrolling up (mouse/trackpad) enters tmux copy-mode — a frozen viewport
• Claude keeps outputting below; your scroll position is untouched
• Press q or scroll back to the bottom to exit copy-mode

Quick reference

Action	Key
Scroll up	Mouse/trackpad (auto enters copy-mode)
Exit copy-mode	q or scroll to bottom
Split pane vertical	Ctrl-Space then |
Split pane horizontal	Ctrl-Space then -
Switch panes	Alt+Arrow
Detach (leave running)	Ctrl-Space then d
Reattach	tmux attach

Requirements

• macOS or Linux
• Homebrew (installer uses it to install tmux if missing)
• Claude Code

Uninstall

rm ~/.local/bin/cc
rm ~/.tmux.conf          # or restore from ~/.tmux.conf.bak