claude-code - 💡(How to fix) Fix [DOCS] `/resume` docs still describe the session picker as interactive-only and omit background-session support

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/sessions

Section/Topic

"Resume a session," "Where the session picker looks," and "Use the session picker"

Current Documentation

The docs currently say:

| claude --continue | Resumes the most recent session in the current directory | | claude --resume | Opens the session picker | | claude --resume <name> | Resumes the named session directly | | claude --from-pr <number> | Resumes the session linked to that pull request | | /resume | Switches to a different conversation from inside an active session |

Sessions created with claude -p or the Agent SDK do not appear in the session picker, but you can still resume one by passing its session ID to claude --resume <session-id>.

By default the session picker shows interactive sessions from the current worktree, plus sessions started elsewhere that added the current directory with /add-dir.

What's Wrong or Missing?

Claude Code v2.1.144 added /resume support for background sessions.

The current sessions page still describes the picker as showing interactive sessions from the current worktree and does not document that sessions started via claude --bg or agent view now appear there as well.

It also does not mention the new bg marker, so users are not told how to distinguish background sessions from interactive ones in the picker.

Suggested Improvement

Update the resume/session-picker docs to reflect the v2.1.144 behavior.

For example, in the "Where the session picker looks" or "Use the session picker" sections, add a note like:

On Claude Code v2.1.144 and later, the /resume picker also shows background sessions started via claude --bg or agent view alongside interactive sessions. Mark those rows with bg and explain that they can be resumed from the picker the same way as interactive sessions.

If there are scope or filtering differences between interactive and background sessions, document those in the same section.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 1 page affected

Version context: The v2.1.144 changelog at https://code.claude.com/docs/en/changelog says: "Added /resume support for background sessions — sessions started via claude --bg or agent view now appear alongside interactive ones, marked with bg".