[DOCS] Keybindings docs missing ctrl+u/ctrl+d mode-specific behavior (kill-line vs scroll)

Status Fixed / completed
Maintainer reply None cached
Activity 4 comments · opened Mar 18, 2026 · closed May 10, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Default keybindings reference and mode-specific behavior

Current Documentation

The keybindings page mentions ctrl+u only as an example of a binding that can be unbound ("ctrl+u": null). It documents Ctrl+D as app:exit. The transcript actions section lists transcript:toggleShowAll and transcript:exit but does not document any scroll actions or their mode-specific scoping.

No documentation describes:

  • ctrl+u as readline kill-line in normal/chat mode
  • ctrl+u/ctrl+d as half-page scroll in transcript mode
  • That these keybindings have different behavior depending on the active mode

What's Wrong or Missing?

Changelog v2.1.78 fixed ctrl+u in normal mode scrolling instead of performing readline kill-line, and moved ctrl+u/ctrl+d half-page scroll to transcript mode only. This reveals mode-specific keybinding behavior that is not documented:

  • Normal/chat mode: ctrl+u = readline kill-line (clear text before cursor)
  • Transcript mode: ctrl+u = half-page scroll up, ctrl+d = half-page scroll down

Users who relied on ctrl+u/ctrl+d for scrolling in normal mode will find the behavior has changed, and the keybindings reference provides no guidance on mode-specific behavior.

Suggested Improvement

Add a mode-specific keybindings section or table:

Normal/Chat mode:
| Key | Action |
|-----|--------|
| Ctrl+U | Kill line (clear text before cursor) |
| Ctrl+D | Exit application |

Transcript mode:
| Key | Action |
|-----|--------|
| Ctrl+U | Half-page scroll up |
| Ctrl+D | Half-page scroll down |

Impact

Low - Minor confusion or inconvenience

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/keybindings | Default keybindings reference and transcript actions |

Total scope: 1 page affected

Source: Changelog v2.1.78

Fixed ctrl+u in normal mode scrolling instead of readline kill-line (ctrl+u/ctrl+d half-page scroll moved to transcript mode only)

View original on GitHub ↗

4 Comments

coygeek · 6 months ago

Correction after a full re-verification on 2026-04-01: this issue is still only partially resolved, not resolved. The docs now cover chat-input Ctrl+U and transcript-mode Ctrl+U/Ctrl+D scrolling on separate pages, but the keybindings reference still does not give a single clear mode-scoped explanation and still presents Ctrl+D too broadly as exit-only, so this should remain open.

coygeek · 5 months ago

Checked against the latest docs mirror — this issue is still unresolved as of 2026-04-27.

Verification details:

  • keybindings.md mentions ctrl+u only as an example of a binding to unbind (line 27), not as a default readline kill-line action in any action table.
  • app:exit (Ctrl+D) is documented as a global action and as a reserved shortcut (hardcoded exit), with no mention of half-page scroll behavior in transcript mode.
  • The Transcript actions table (lines 156–162) lists only transcript:toggleShowAll and transcript:exit — no scroll actions.
  • The Scroll actions (lines 314–337) are scoped to the Scroll context (fullscreen mode) with scroll:halfPageUp/scroll:halfPageDown shown as (unbound), not bound to ctrl+u/ctrl+d.
  • The interactive-mode transcript viewer section (lines 87–96) also omits ctrl+u/ctrl+d scroll shortcuts.
  • No documentation anywhere describes mode-specific keybinding behavior for these keys.
coygeek · 5 months ago

Issue #35627 Verification

Title: [DOCS] Keybindings docs missing ctrl+u/ctrl+d mode-specific behavior (kill-line vs scroll)
Issue Date: 2026-03-18
Verification Date: 2026-05-10
Status: RESOLVED

---

Issue Summary

This issue reports that the documentation did not explain the mode-specific behavior of Ctrl+U and Ctrl+D, specifically that Ctrl+U should act as readline kill-line in normal/chat mode while Ctrl+U and Ctrl+D should perform half-page scrolling in transcript mode.

---

Verification Results

Claim 1: Normal/chat mode behavior for Ctrl+U is now documented

Status: RESOLVED

At https://code.claude.com/docs/en/interactive-mode, lines 45-55, the Text editing table documents Ctrl+U as Delete from cursor to line start and adds that it stores deleted text for pasting and can be repeated across lines in multiline input. At the same page, lines 23-30 document Ctrl+D in the General controls table as Exit Claude Code session.

Verdict: The current docs explicitly describe the normal/chat mode behavior that the issue said was missing.

---

Claim 2: Transcript mode scrolling behavior for Ctrl+U and Ctrl+D is now documented

Status: RESOLVED

At https://code.claude.com/docs/en/fullscreen, lines 98-110, the transcript mode navigation table states that transcript mode gains less-style navigation and documents Ctrl+u / Ctrl+d as Scroll half a page.

Verdict: The current docs explicitly document the transcript-mode half-page scrolling behavior for Ctrl+U and Ctrl+D.

---

Claim 3: Mode-specific behavior is now communicated clearly enough for users

Status: RESOLVED

At https://code.claude.com/docs/en/interactive-mode, lines 45-55, Ctrl+U is documented under the Text editing section for prompt input. At https://code.claude.com/docs/en/fullscreen, lines 98-110, Ctrl+u / Ctrl+d are documented specifically under transcript mode navigation. At https://code.claude.com/docs/en/changelog, line 1174, the changelog entry states: Fixed ctrl+u in normal mode scrolling instead of readline kill-line (ctrl+u/ctrl+d half-page scroll moved to transcript mode only).

Verdict: The docs now separate the behaviors by mode and align with the changelog change described in the issue.

---

Current State

| Claim | Status |
|-------|--------|
| Ctrl+U normal/chat-mode kill-line behavior is documented | RESOLVED |
| Ctrl+U and Ctrl+D transcript-mode half-page scrolling is documented | RESOLVED |
| Mode-specific behavior is explained across the relevant docs | RESOLVED |

---

Suggested Fix

N/A - issue has been resolved.

---

References

---

Conclusion & Recommendation

Primary Concern: The issue reported that the docs did not explain the mode-specific Ctrl+U and Ctrl+D behaviors between prompt editing and transcript scrolling.

Resolution Status: RESOLVED

Recommendation: CLOSE

The current documentation now covers the prompt-editing behavior in interactive-mode and the transcript scrolling behavior in fullscreen, which addresses the missing mode-specific guidance described in the issue.

---

github-actions[bot] · 3 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.