[DOCS] Interactive mode docs missing queued-message editing shortcuts after Escape behavior change

Status Fixed / completed
Maintainer reply None cached
Activity 6 comments · opened Mar 5, 2026 · closed Jun 23, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Queued-message editing and interruption keyboard behavior.

Current Documentation

The bash mode section currently documents:

Exit with Escape, Backspace, or Ctrl+U on an empty prompt

There is no documentation for queued-message retrieval/editing (Up arrow) or draft-text behavior during turn interruption.

What's Wrong or Missing?

Changelog v2.1.69 clarifies behavior when draft text is present:

  • Escape does not interrupt a running turn if the input box has draft text
  • Up arrow retrieves queued messages for editing
  • Ctrl+U clears the input line

These behaviors are not documented in interactive mode guidance.

Suggested Improvement

Add a short "Interruptions and queued messages" subsection with:

  • Escape behavior when draft text exists
  • Up arrow retrieval/editing flow for queued messages
  • Ctrl+U clear-line behavior in this context

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | Primary source for keyboard and input behavior; missing queued-message editing details |

Total scope: 1 page affected

Source: Changelog v2.1.69

Exact changelog entry:

Fixed Escape not interrupting a running turn when the input box has draft text. Use Up arrow to pull queued messages back for editing, or Ctrl+U to clear the input line.

View original on GitHub ↗

6 Comments

coygeek · 6 months ago

Still unresolved as of 2026-03-28 after re-checking the current docs. The documentation gap described in this issue is still present.

coygeek · 6 months ago

Quickly checked the latest docs again. Parts of this issue may be improved, but it is still not fully resolved, so it should stay open.

coygeek · 5 months ago

Just checked the current docs again. This issue is not fully resolved yet.

coygeek · 4 months ago

Still relevant as of 2026-05-28. I checked the current docs and this documentation gap still appears unresolved.

coygeek · 3 months ago

Issue #30940 Verification

Title: [DOCS] Interactive mode docs missing queued-message editing shortcuts after Escape behavior change
Issue Date: 2026-03-05
Verification Date: 2026-06-23
Status: RESOLVED

---

Issue Summary

The issue reports that https://code.claude.com/docs/en/interactive-mode does not document the queued-message retrieval and draft-text behavior introduced by Claude Code v2.1.69. Specifically, the reporter notes that the bash mode section still only documents Exit with Escape, Backspace, or Ctrl+U on an empty prompt and lacks coverage of:

  • Escape not interrupting a running turn when the input box has draft text
  • Up arrow retrieving queued messages for editing
  • Ctrl+U clearing the input line in this context

The reporter requested a short "Interruptions and queued messages" subsection covering these three behaviors.

---

Verification Results

Claim 1: The interactive mode page still only documents the bash mode exit shortcuts with no coverage of Escape/draft-text, Up arrow retrieval, or Ctrl+U in the interruption context.

Status: RESOLVED

The interactive mode page now documents each of these behaviors. The General controls table at https://code.claude.com/docs/en/interactive-mode, line 40 contains a dedicated Esc + Esc row:

Esc + Esc | Clear input draft, or rewind | When the prompt input contains text, double Esc clears it and saves the draft to history so Up recalls it. When the input is empty, double Esc opens the rewind menu to restore or summarize code and conversation from a previous point

This row documents both of the v2.1.69 fix points from the issue:

  • Escape behavior with draft text: Double Esc is the path that clears the draft. The companion Esc row at line 39 (Esc | Interrupt Claude | Stop the current response or tool call mid-turn so you can redirect. Claude keeps the work done so far) describes single-press Esc only as an interrupt, implicitly confirming that the single-press no longer clears draft text — matching the changelog note that Escape does not interrupt a running turn if the input box has draft text.
  • Up arrow retrieval/editing flow: The Esc + Esc context explicitly states so Up recalls it, covering the v2.1.69 Up arrow retrieves queued messages for editing note.

The Text editing table at https://code.claude.com/docs/en/interactive-mode, line 53 documents Ctrl+U:

Ctrl+U | Delete from cursor to line start | Stores deleted text for pasting. Repeat to clear across lines in multiline input. On macOS, terminal emulators including iTerm2 and Terminal.app map Cmd+Backspace to this shortcut

This is a standard text-editing entry, but it directly documents the Ctrl+U clears the input line behavior the issue asked for. The Up/Down arrows or Ctrl+P/Ctrl+N row at line 38 also documents history navigation that the Up arrow participates in.

The reporter's recommended "Interruptions and queued messages" subsection was not added as a single dedicated section, but every behavior flagged in the issue is now documented in the existing tables.

Verdict: All three behaviors the issue flagged (Escape with draft text, Up arrow retrieval, Ctrl+U clear) are now documented on the interactive mode page, so the gap is closed.

---

Current State

| Claim | Status |
|-------|--------|
| Interactive mode docs cover Escape/draft-text, Up arrow retrieval, and Ctrl+U in the interruption context | RESOLVED |

---

Suggested Fix

N/A - issue has been resolved.

---

References

  • URL: https://code.claude.com/docs/en/interactive-mode
  • Line 38: Up/Down arrows or Ctrl+P/Ctrl+N history-navigation row
  • Line 39: Esc interrupt row ("Interrupt Claude")
  • Line 40: Esc + Esc row documenting draft-text behavior and Up recall
  • Line 53: Ctrl+U row in the Text editing table

---

Conclusion & Recommendation

Primary Concern: The interactive mode page did not document the v2.1.69 changes around Escape behavior with draft text, Up arrow retrieval of queued messages, or Ctrl+U clear-line behavior.

Resolution Status: RESOLVED

Recommendation: CLOSE

The interactive mode page now documents all three behaviors the issue called out, in the General controls and Text editing tables, with the Esc + Esc row in particular covering the draft-text and Up-arrow retrieval cases from changelog v2.1.69.

github-actions[bot] · 1 month 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.