[DOCS] Agent view docs omit the left-arrow edit confirmation and return-to-conversation behavior

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/agent-view

Section/Topic

The agent-view quick-start navigation and the “Attach and detach” / “From inside a session” keyboard behavior.

Current Documentation

The quick start currently says:

Agent view opens with an input at the bottom and a table that fills in as sessions start. Press Esc at any time to return to your shell.

The session guidance says:

In a session running in the foreground... pressing ← on an empty prompt backgrounds it and opens agent view with that row selected...

It does not describe what happens when the prompt has just been edited, or how Esc behaves when returning from the agent view created by that action.

What's Wrong or Missing?

Claude Code 2.1.218 changed the left-arrow flow to avoid discarding a conversation without an undo path. Pressing ← shortly after editing now asks for confirmation instead of immediately backgrounding or discarding the edited state.

The release also makes Esc in agent view return to the conversation that was backgrounded. The current “return to your shell” wording is too broad and can lead users to leave agent view without understanding how to get back to the conversation they just moved.

Suggested Improvement

Update the keyboard-navigation instructions with a versioned note covering both cases:

• If the prompt was edited immediately before pressing ←, Claude Code shows a confirmation before proceeding, so the user can preserve the edited conversation state.
• When agent view was opened by backgrounding the current conversation, Esc returns to that conversation; otherwise it exits agent view to the shell as documented.

Add a short sequence such as “edit prompt → press ← → confirm or cancel → use Esc to return” so the navigation and safety behavior are explicit.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/agent-view | Quick start, attach/detach, and foreground-session backgrounding |
| https://code.claude.com/docs/en/interactive-mode | Cross-reference for prompt editing and navigation shortcuts |
| https://code.claude.com/docs/en/keybindings | Cross-reference for configurable navigation actions |

Total scope: 3 pages should describe the same left-arrow navigation safety contract.

The behavior was changed in Claude Code v2.1.218.