[DOCS] `/diff` detail view docs omit keyboard scrolling shortcuts

Open 💬 1 comment Opened May 22, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

/diff command entry, especially the transition from the file list into the detail view

Current Documentation

The docs currently say:

/diff | Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use left/right arrows to switch between the current git diff and individual Claude turns, and up/down to browse files

The keyboard reference currently says:

Actions available in the DiffDialog context: diff:dismiss — Close diff viewer diff:previousSource — Previous diff source diff:nextSource — Next diff source diff:previousFile — Previous file in diff diff:nextFile — Next file in diff diff:viewDetails — View diff details

What's Wrong or Missing?

Claude Code v2.1.149 added keyboard scrolling inside the /diff detail view, but the docs still stop at opening the detail view.

They do not tell readers that, once the detail view is open, they can scroll it with arrows, j/k, PgUp/PgDn, Space, and Home/End.

That leaves two gaps:

A. The /diff command docs describe only source switching and file navigation

Readers can see how to open the diff viewer and move between sources/files, but not how to navigate within a long diff after pressing Enter to open details.

B. The keyboard reference stops before detail-view scrolling behavior

The keybindings page shows how to enter the detail view, but it does not document the available scroll keys there or explain whether that detail view uses fixed keys or rebindable actions.

Suggested Improvement

Update the /diff documentation to include a short detail-view navigation note, for example:

Press Enter to open a file's detail view. In that view, use / or j/k to scroll line by line, PgUp/PgDn or Space to page, and Home/End to jump to the beginning or end.

Also update the keyboard shortcut reference so the detail-view scrolling behavior is discoverable from the keybindings docs. If these keys map to rebindable actions, list those action names there; if they are fixed, note that explicitly.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 62 | /diff description covers source/file navigation only |
| https://code.claude.com/docs/en/keybindings | 246-258 | DiffDialog actions cover opening details, but not scrolling within the detail view |

Total scope: 2 pages affected

This gap became user-visible in changelog v2.1.149, which announces that the /diff detail view can now be scrolled with the keyboard.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗