[DOCS] Interactive mode docs omit overflow dialog scrolling controls
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/interactive-mode
Section/Topic
Keyboard shortcuts and dialog navigation for overflowed dialogs
Current Documentation
The docs currently say:
Left/Right arrows | Cycle through dialog tabs | Navigate between tabs in permission dialogs and menus
The keybindings reference says:
### Confirmation actionsconfirm:previous| Up | Previous optionconfirm:next| Down | Next option
And the fullscreen guide says:
Fullscreen rendering handles scrolling inside the app. Use these shortcuts to navigate:PgUp/PgDn| Scroll up or down by half a screenCtrl+Home| Jump to the start of the conversationCtrl+End| Jump to the latest message and re-enable auto-follow Mouse wheel | Scroll a few lines at a time
These passages cover tab switching, list navigation, and fullscreen transcript scrolling, but they do not document that overflowing dialogs themselves can be scrolled with arrow keys, PgUp/PgDn, Home/End, and the mouse wheel in both fullscreen and non-fullscreen modes.
What's Wrong or Missing?
Changelog v2.1.121 added this behavior:
Dialogs that overflow the terminal are now scrollable with arrow keys, PgUp/PgDn, home/end, and mouse wheel in both fullscreen and non-fullscreen modes
The current docs do not tell users that long dialogs have their own scroll behavior, which keys work, or that the behavior is available even when the fullscreen renderer is off. On short terminals or in long permission, settings, and picker dialogs, users can miss content and assume the hidden portion is inaccessible.
Suggested Improvement
Add a short "Overflow dialogs" subsection to the interactive keyboard docs, or add equivalent entries to the keybindings reference, covering:
- Arrow-key scrolling for dialogs whose content exceeds the terminal height
- PgUp/PgDn for larger scroll jumps
- Home/End for jumping within the dialog
- Mouse-wheel scrolling when the terminal forwards mouse events
- An explicit note that this works in both fullscreen and default/non-fullscreen rendering modes
It would also help to add a cross-reference from the fullscreen page so its scroll section does not read as if these controls only apply to the fullscreen transcript view.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/interactive-mode | 37-38 | Dialog tab navigation is documented, but overflow-dialog scrolling is not |
| https://code.claude.com/docs/en/keybindings | 133-145, 316-337 | Confirmation actions and fullscreen scroll actions are documented separately, but there is no overflow-dialog scroll reference |
| https://code.claude.com/docs/en/fullscreen | 61-86 | Scroll controls are described for fullscreen conversation navigation, which leaves the new dialog behavior and non-fullscreen scope undocumented |
Total scope: 3 pages affected
Source: Changelog v2.1.121
Exact changelog entry:
Dialogs that overflow the terminal are now scrollable with arrow keys, PgUp/PgDn, home/end, and mouse wheel in both fullscreen and non-fullscreen modes
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗