[DOCS] `/resume` picker docs are outdated on current-directory default and `Ctrl+A` toggle
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/common-workflows
Section/Topic
Resume previous conversations / Use the session picker, plus the resume-scope wording in Work across branches
Current Documentation
The docs currently say:
Sessions are stored per project directory. The /resume picker shows interactive sessions from the same git repository, including worktrees. When you select a session from another worktree of the same repository, Claude Code resumes it directly without requiring you to switch directories first.
And the shortcut table on the same page says:
| A | Toggle between current directory and all projects |
On how-claude-code-works, the current wording is:
Each Claude Code conversation is a session tied to your current directory. When you resume, you only see sessions from that directory.
What's Wrong or Missing?
Changelog v2.1.108 says:
Improved/resumepicker to default to sessions from the current directory; pressCtrl+Ato show all projects
The current docs are not aligned with that behavior:
A. The default picker scope is inconsistent
common-workflows describes the picker as showing sessions from the same git repository, while how-claude-code-works says you only see sessions from the current directory. After v2.1.108, the docs should describe one clear default: the picker starts with sessions from the current directory, with an explicit way to expand to all projects.
B. The documented shortcut is outdated
The session-picker shortcut table still documents A, but the changelog calls out Ctrl+A for showing all projects. Users reading the docs cannot tell which keybinding is current.
Suggested Improvement
Update the /resume documentation to match the v2.1.108 behavior:
- In
common-workflows, state explicitly that the picker defaults to sessions from the current directory. - Update the shortcut table to document
Ctrl+Afor switching to the all-projects view, or clarify if bothAandCtrl+Aare supported. - Keep the worktree note, but explain it in terms of the default current-directory view versus the expanded all-projects view.
- Align
how-claude-code-workswith the same wording so the two pages no longer describe different default scopes.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/common-workflows | /resume picker behavior and keyboard shortcuts |
| https://code.claude.com/docs/en/how-claude-code-works | High-level explanation of which sessions appear when resuming |
Total scope: 2 pages affected
Source: Changelog v2.1.108
Exact changelog entry: Improved /resume picker to default to sessions from the current directory; press Ctrl+A to show all projects
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗