[DOCS] Agent view docs overstate what `←` does from a fresh REPL and omit the onboarding empty state
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/agent-view
Section/Topic
"Bring an existing session in", "Attach to a session", and "Agent view opens with no sessions"
Current Documentation
The page currently says:
To move a session you already have open into agent view, run/bginside it, or press←on an empty prompt to background it and open agent view in one step. The session keeps running and appears as a row alongside the ones you dispatched.
Later on the same page it also says:
After you've dispatched or backgrounded a session, pressing ← on an empty prompt works from any Claude Code session, not only ones you attached to from agent view. It backgrounds the current session and opens agent view with that session pre-selected, so you can switch sessions without leaving the terminal.
And the troubleshooting section says:
Agent view is empty until you dispatch your first session. Type a prompt in the input at the bottom and press Enter.
What's Wrong or Missing?
In v2.1.141, claude agents no longer shows an empty placeholder session when you enter agent view by pressing ← from a fresh REPL with no other agents, and that entry path now shows onboarding text.
The current page still describes ← as if it always backgrounds the current session into a visible row and pre-selects it. That overstates what happens for a fresh, unused REPL.
The troubleshooting text also describes the empty state only as an empty list, without noting the onboarding text shown for this ← entry path.
Suggested Improvement
Update the ← navigation docs to distinguish between an existing session and a fresh REPL.
Suggested change:
Before:
press ← on an empty prompt to background it and open agent view in one step. The session keeps running and appears as a row
After:
press ← on an empty prompt to open agent view. If the current session already has conversation state, Claude backgrounds it and shows it as a row. If you enter from a fresh REPL with no other agents, Claude opens agent view without leaving an empty placeholder session and shows the onboarding empty state instead.
Also update the troubleshooting section so the empty-state behavior matches the current v2.1.141 UI.
Impact
Low - Minor confusion or inconvenience
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 64-65 | Says ← backgrounds the current session and the session appears as a row |
| https://code.claude.com/docs/en/agent-view | 155-159 | Says ← backgrounds the current session and opens agent view with that session pre-selected |
| https://code.claude.com/docs/en/agent-view | 354-356 | Describes the no-sessions state as empty, without the onboarding text noted in v2.1.141 |
Total scope: 1 page affected
Relevant version context: the Claude Code v2.1.141 changelog says claude agents no longer shows empty placeholder sessions left over from backgrounding a fresh REPL, and shows onboarding text when entered via ← with no other agents.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗