[BUG] Fullscreen TUI mode has janky/non-smooth scrolling
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
With "tui": "fullscreen" enabled in settings.json, scrolling through conversation history is noticeably janky — it jumps in large chunks rather than scrolling smoothly line-by-line like in the default TUI mode.
What Should Happen?
Scrolling should be smooth and proportional to scroll input, similar to the default TUI mode.
Error Messages/Logs
Steps to Reproduce
- Set "tui": "fullscreen" in settings.json
- Have a conversation long enough to require scrolling
- Scroll up/down through the conversation history
- Observe: scrolling is choppy/jumpy compared to the default TUI mode
Claude Model
Opus
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.1.118 - @anthropic-ai/claude-code
Platform
Other
Operating System
macOS
Terminal/Shell
Terminal.app (macOS)
Additional Information
I switched to fullscreen mode to work around the scrollback duplication that happens in default mode when resizing the terminal window (see also the duplicate frames in scrollback when resizing: https://github.com/anthropics/claude-code/issues?q=is%3Aissue+scrollback+resize). Fullscreen mode fixes that problem, but introduces this scrolling regression.
Ideally both issues would be resolved so we don't have to pick between clean scrollback and smooth scrolling.
Btw: I'm sorry I haven't tested the very latest version! My installation is controlled by my company and I don't have a choice over which version to use.
8 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
Confirming on Windows — not macOS-only.
Environment
Repro
/tui fullscreen.Behavior
Scrolling jumps in large chunks and feels laggy/smoothed — overshoots the target line and makes it hard to stop where I want. Switching to
/tui defaultin the same session/terminal scrolls smoothly and snappily, so it's not a terminal/PowerShell issue — it's specific to fullscreen mode.Workaround
/tui defaultrestores snappy scrolling but loses flicker-free rendering.Confirming this in iTerm2 + tmux on macOS.
2.1.15026.53.6.103.6aFor fullscreen-mode users this isn't a tradeoff between scrollback and smooth scrolling — fullscreen is the only viable mode for some setups, and once you're in it Claude owns all scroll handling, so no terminal-side config can route around the jank.
For me the lag is mouse-wheel scrolling — keyboard scrolling is fine on my own custom bindings, and isn't what I'm reporting. Likely the same root cause as #9935 (excessive wheel events not being coalesced before render).
Note on client-side workarounds
I considered OS-level scroll throttling (Mos, LinearMouse). Both are global; per-app exception scope is "iTerm" not "Claude Code inside iTerm" — would also throttle vim, less, my shell, and every other terminal-native tool. Not viable as a clean test, so I didn't try it.
Also experiencing this on the Windows 11 version of fullscreen TUI mode for Claude Code in the terminal, which only appeared for me as an option in the last day or two. Git bash. Configuring or testing with the scroll speed variable
/scroll-speedhas no effect - all "speeds" scroll at the same rate.Update: appears this is now fixed with the wheelScrollAccelerationEnabled flag, currently undocumented. References:
https://github.com/anthropics/claude-code/issues/67740
https://github.com/anthropics/claude-code/issues/65323
its really bad on my mac
i really wonder did they ever tested it had to revert as soon as i enabled it
I am still experiencing this issue.
@mgroth0 hello, did you find some possible solution for your case?
my case is very similar to yours here
details: