claude-code - 💡(How to fix) Fix [DOCS] Interactive mode docs omit the Ctrl+R history picker's new default scope [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#56493Fetched 2026-05-06 06:26:35
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
labeled ×3

Root Cause

In v2.1.129, the Ctrl+R history picker now starts by searching all prompts across all projects. The current page explains that Ctrl+S cycles scopes, but it never says which scope Ctrl+R starts in. Because the section is introduced as "command history for the current session," the current wording also points readers toward a session-local interpretation instead of the new all-project default.

RAW_BUFFERClick to expand / collapse

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

"Command history" → "Reverse search with Ctrl+R"

Current Documentation

The docs currently say:

Claude Code maintains command history for the current session:

  • Input history is stored per working directory
  • Input history resets when you run /clear to start a new session. The previous session's conversation is preserved and can be resumed.
  • Use Up/Down arrows to navigate (see keyboard shortcuts above)

Press Ctrl+R to interactively search through your command history:

  1. Start search: press Ctrl+R to activate reverse history search
  2. Type query: enter text to search for in previous commands. The search term is highlighted in matching results
  3. Navigate matches: press Ctrl+R again to cycle through older matches
  4. Change scope: press Ctrl+S to cycle between this session, this project, and all projects

What's Wrong or Missing?

The reverse-search docs do not reflect the v2.1.129 behavior change.

In v2.1.129, the Ctrl+R history picker now starts by searching all prompts across all projects. The current page explains that Ctrl+S cycles scopes, but it never says which scope Ctrl+R starts in. Because the section is introduced as "command history for the current session," the current wording also points readers toward a session-local interpretation instead of the new all-project default.

Suggested Improvement

Update the Ctrl+R instructions to state the starting scope explicitly.

Before:

Press Ctrl+R to interactively search through your command history:

  1. Change scope: press Ctrl+S to cycle between this session, this project, and all projects

After:

Press Ctrl+R to open the history picker. In Claude Code v2.1.129 and later, it starts by searching all prompts across all projects.

Press Ctrl+S to narrow the scope from all projects to this project, then to this session.

If helpful, add a short note that this restores the pre-v2.1.124 default behavior.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageLine(s)Context
https://code.claude.com/docs/en/interactive-mode208-224Reverse-search instructions describe scope cycling but omit that Ctrl+R now starts in the all-project scope

Total scope: 1 page affected

Related documentation:

PageContext
https://code.claude.com/docs/en/keybindingsLists historySearch:cycleScope on Ctrl+S; useful cross-reference if the reverse-search docs are updated

extent analysis

TL;DR

Update the Ctrl+R instructions in the documentation to explicitly state that it starts searching all prompts across all projects by default in Claude Code v2.1.129 and later.

Guidance

  • Review the current documentation for "Command history" → "Reverse search with Ctrl+R" and identify the sections that need updates to reflect the v2.1.129 behavior change.
  • Update the Ctrl+R instructions to include the starting scope, as suggested in the "After" example provided in the issue.
  • Verify that the updated documentation accurately reflects the current behavior of Ctrl+R in v2.1.129 and later versions.
  • Consider adding a note to explain that this update restores the pre-v2.1.124 default behavior for clarity.

Example

The updated documentation could look like this:

Press Ctrl+R to open the history picker. In Claude Code v2.1.129 and later, it starts by searching all prompts across all projects.

Press Ctrl+S to narrow the scope from all projects to this project, then to this session.

Notes

The update should only be applied to the affected page, which is https://code.claude.com/docs/en/interactive-mode, lines 208-224.

Recommendation

Apply the workaround by updating the documentation as suggested, to ensure that users have accurate information about the Ctrl+R behavior in v2.1.129 and later versions.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING