[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 withclaude -por the Agent SDK do not appear in the session picker, but you can still resume one by passing its session ID toclaude --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/resumepicker also shows background sessions started viaclaude --bgor agent view alongside interactive sessions. Mark those rows withbgand 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:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/sessions | 23-35, 61-76 | /resume entry points and session-picker scope still describe an interactive-only view |
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".
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗