[FEATURE] support mouse scrolling in tmux
Status Fixed / completed
Maintainer reply ✓ Yes — bcherny
Activity 4 comments · opened Dec 30, 2025 · closed Aug 17, 2026
💡 Likely answer: A maintainer (bcherny, collaborator)
responded on this thread — see the highlighted reply below.
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
Currently, it's not possible to scroll up or down within a tmux session when using Claude, preventing you from viewing the complete terminal output.
<img width="1369" height="984" alt="Image" src="https://github.com/user-attachments/assets/afd7b45b-1aa4-4c5b-8d77-36104f8d8878" />
Proposed Solution
Increase relevant support.
Alternative Solutions
_No response_
Priority
High - Significant impact on productivity
Feature Category
CLI commands and flags
Use Case Example
_No response_
Additional Context
_No response_
4 Comments
The Tmux mode of mouse scrolling is controlled by
~/.tmux.confI don't know how your interaction between Tmux and Claude Code is setup, but at least I'm getting "normal" mouse scrolling when using them together on Ubuntu this way https://github.com/marcindulak/stt-mcp-server-linux?tab=readme-ov-file#usage-examples
+1 for this feature. I use speech-to-text, so scroll wheel support would let me navigate Claude Code entirely with voice + mouse - a significant accessibility win.
I added the following to my ~/.tmux.conf and it fixed it:
Then, restart your tmux server, or load the config in an active session by pressing
ctrl-b, type:source-file ~/.tmux.conf, and hit returnThis works today with fullscreen rendering. Run
/tui fullscreenin Claude Code (new installs get it by default), and enable tmux's mouse mode by addingset -g mouse onto~/.tmux.confand reloading it. The mouse wheel then scrolls the conversation inside Claude Code;PgUp/PgDnwork either way. Details: https://code.claude.com/docs/en/fullscreen#use-with-tmuxClosing since it's covered — please reopen if it doesn't work for you after enabling mouse mode.
🤖 Generated with Claude Code