claude-code - 💡(How to fix) Fix [DOCS] Interactive mode reference omits Cmd+Left/Cmd+Right line navigation

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
RAW_BUFFERClick to expand / collapse

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

Keyboard shortcuts → Text editing (macOS line-start/end navigation shortcuts)

Current Documentation

The page describes itself as:

Complete reference for keyboard shortcuts, input modes, and interactive features in Claude Code sessions.

But the current Text editing table only documents deletion, paste, and word navigation shortcuts:

| Ctrl+K | Delete to end of line | Stores deleted text for pasting | | Ctrl+U | Delete from cursor to line start | Stores deleted text for pasting. Repeat to clear across lines in multiline input | | Ctrl+Y | Paste deleted text | Paste text deleted with Ctrl+K or Ctrl+U | | Alt+Y (after Ctrl+Y) | Cycle paste history | After pasting, cycle through previously deleted text. Requires Option as Meta on macOS | | Alt+B | Move cursor back one word | Word navigation. Requires Option as Meta on macOS | | Alt+F | Move cursor forward one word | Word navigation. Requires Option as Meta on macOS |

The terminal-specific setup page also documents other terminal-dependent shortcut behavior, for example:

Shift+Enter: Works out of the box in iTerm2, WezTerm, Ghostty, and Kitty

Run /terminal-setup within Claude Code to automatically configure Shift+Enter for VS Code, Alacritty, Zed, and Warp.

What's Wrong or Missing?

Claude Code v2.1.116 fixed Cmd+Left / Cmd+Right so they jump to the start/end of the line in terminals that use the Kitty keyboard protocol, specifically including Warp fullscreen, kitty, Ghostty, and WezTerm.

That user-facing shortcut behavior is not documented in the interactive shortcut reference at all. The docs currently cover related text-editing shortcuts and already call out terminal-specific differences for other keys, but they do not tell macOS users that line-start/end navigation via Cmd+Left and Cmd+Right is supported, or which terminal/protocol combinations matter.

As written, the “complete reference” is incomplete for prompt-editing navigation.

Suggested Improvement

Add Cmd+Left and Cmd+Right to the Text editing shortcut table in interactive-mode with descriptions such as:

  • Cmd+Left — Move cursor to start of line
  • Cmd+Right — Move cursor to end of line

Also add a short macOS/terminal note explaining the intended support scope after v2.1.116, for example that these shortcuts work in Kitty-keyboard-protocol terminals such as kitty, Ghostty, WezTerm, and Warp fullscreen, or otherwise link to terminal-config if terminal-specific caveats belong there.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageContext
https://code.claude.com/docs/en/interactive-modePrimary keyboard shortcut reference for prompt editing
https://code.claude.com/docs/en/terminal-configTerminal-specific shortcut/setup page that already documents terminal differences for input shortcuts

Total scope: 2 pages affected

Source: Changelog v2.1.116

Changelog entry: Fixed Cmd+Left/Right not jumping to line start/end in terminals that use the Kitty keyboard protocol (Warp fullscreen, kitty, Ghostty, WezTerm)

extent analysis

TL;DR

Update the documentation for keyboard shortcuts in interactive mode to include Cmd+Left and Cmd+Right for line-start/end navigation on macOS.

Guidance

  • Add Cmd+Left and Cmd+Right to the Text editing shortcut table with descriptions for moving the cursor to the start and end of the line.
  • Include a note explaining that these shortcuts are supported in Kitty-keyboard-protocol terminals such as kitty, Ghostty, WezTerm, and Warp fullscreen.
  • Review the terminal-config page to ensure consistency in documenting terminal-specific shortcut behavior.
  • Verify the updated documentation by checking the Text editing table in the interactive mode reference and the terminal-specific setup page.

Example

The updated Text editing table could include the following entries:

ShortcutActionDescription
Cmd+LeftMove cursor to start of lineSupported in Kitty-keyboard-protocol terminals
Cmd+RightMove cursor to end of lineSupported in Kitty-keyboard-protocol terminals

Notes

The update should be applied to the primary keyboard shortcut reference page (https://code.claude.com/docs/en/interactive-mode) and potentially the terminal-specific setup page (https://code.claude.com/docs/en/terminal-config) for consistency.

Recommendation

Apply the workaround by updating the documentation to include the missing shortcuts and notes on supported terminals, as this will improve the completeness and accuracy of the reference material.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING