[DOCS] Agent view docs overstate what `←` does from a fresh REPL and omit the onboarding empty state

Resolved 💬 1 comment Opened May 14, 2026 by coygeek Closed May 14, 2026

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 /bg inside 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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗