Skip to content

cli

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

cli

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
bin
bin
 
 
README.md
README.md
 
 
package.json
package.json
 
 

README.md

claude-code-scroll (CLI)

Runs claude with working terminal scrollback and mouse-wheel scroll.

Claude Code's fullscreen renderer uses the terminal's alternate-screen buffer, which bypasses your terminal's native scrollback entirely, and captures mouse-wheel events as arrow-key navigation instead of letting the terminal handle them. Anthropic ships two env vars that opt out of both (CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN, CLAUDE_CODE_DISABLE_MOUSE) — this is just a one-command way to always use them, so you don't have to remember two undocumented-feeling env var names every time.

Use

npx claude-code-scroll

or install once:

npm install -g claude-code-scroll
claude-scroll

Any arguments are passed straight through to claude (claude-scroll --resume, etc.).

Companion

If you're working in VS Code (or Cursor/Windsurf/VSCodium), see the Claude Code Scroll extension in the repo root — a sidebar panel with a properly scrollable, live-updating transcript instead of a terminal-only fix.

License

MIT