[DOCS] `/resume` picker docs are outdated on current-directory default and `Ctrl+A` toggle

Resolved 💬 2 comments Opened Apr 14, 2026 by coygeek Closed Apr 18, 2026

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 /resume picker to default to sessions from the current directory; press Ctrl+A to 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+A for switching to the all-projects view, or clarify if both A and Ctrl+A are 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-works with 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

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗