[DOCS] Interactive mode docs omit overflow dialog scrolling controls

Open 💬 4 comments Opened Apr 28, 2026 by coygeek

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 actions confirm:previous | Up | Previous option confirm: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 screen Ctrl+Home | Jump to the start of the conversation Ctrl+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

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗