[DOCS] Vim mode `/` prompt-history search docs do not mention the slash-command hint added in v2.1.191

Documentation Type

Unclear/confusing documentation

Documentation Location

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

Section/Topic

Vim editor mode → Navigation (NORMAL mode) table row for / (around line 151), plus the matching Vim mode interaction bullet in the keybindings page (around line 465). Both describe / in NORMAL mode only as opening reverse history search.

Current Documentation

The Vim editor mode → Navigation (NORMAL mode) table in https://code.claude.com/docs/en/interactive-mode says:

| / | Open reverse history search, same as Ctrl+R |

The Vim mode interaction section in https://code.claude.com/docs/en/keybindings says:

When vim mode is enabled via /config → Editor mode, keybindings and vim mode operate independently: Vim mode handles input at the text input level (cursor movement, modes, motions) Keybindings handle actions at the component level (toggle todos, submit, etc.) The Escape key in vim mode switches INSERT to NORMAL mode; it does not trigger chat:cancel Most Ctrl+key shortcuts pass through vim mode to the keybinding system In vim NORMAL mode, ? shows the help menu (vim behavior) In vim NORMAL mode, / opens history search, the same as Ctrl+R in standard mode

The general Command history → Reverse search with Ctrl+R section in interactive-mode (around line 220-238) describes Ctrl+R only, with no mention of the slash-command hint that v2.1.191 added to the equivalent NORMAL-mode / search.

What's Wrong or Missing?

Changelog v2.1.191 says:

Improved vim mode prompt-history search (NORMAL /) to hint how to reach slash commands

So in addition to opening reverse history search (which the v2.1.152 entry already added), the NORMAL-mode / prompt-history search now surfaces a hint telling users how to reach slash commands. The current docs describe only the history-search behavior and omit the hint, so:

A. The interactive-mode NORMAL-mode navigation row is incomplete

interactive-mode lists / solely as "Open reverse history search, same as Ctrl+R". It does not mention that the prompt-history search now also shows a hint about reaching slash commands, even though that hint is part of the same keybinding behavior.

B. The keybindings page "Vim mode interaction" bullet is incomplete

keybindings says / "opens history search, the same as Ctrl+R in standard mode". It does not mention the new slash-command hint, even though the hint is the main user-visible difference between the standard Ctrl+R reverse search and the NORMAL-mode / search after v2.1.191.

C. The general Command history / Reverse search with Ctrl+R guidance is also a partial match

The Ctrl+R description in interactive-mode does not cover the NORMAL-mode / variant at all, so users on current versions who reach for / will see a hint that the durable docs never explain.

Suggested Improvement

Extend the two existing / references so the v2.1.191 hint is part of the documented behavior, and add a short note that explains the difference between the Ctrl+R and NORMAL-mode / searches.

Option A — Update the interactive-mode NORMAL-mode navigation row

Before (line 151 of interactive-mode):

| / | Open reverse history search, same as Ctrl+R |

After (or similar):

| / | Open reverse history search, same as Ctrl+R; the prompt shows a hint telling you how to reach slash commands (v2.1.191+) |

Option B — Update the keybindings "Vim mode interaction" bullet

Before (line 465 of keybindings):

* In vim NORMAL mode, / opens history search, the same as Ctrl+R in standard mode

After (or similar):

* In vim NORMAL mode, / opens history search. As of v2.1.191, the prompt-history search also shows a hint about how to reach slash commands, so NORMAL-mode users can discover commands without leaving the vim-mode prompt

Option C — Add a paragraph to the Command history section

Add a short paragraph below Reverse search with Ctrl+R in interactive-mode:

Vim-mode equivalent (v2.1.191+) When vim mode is enabled, pressing / in NORMAL mode opens the same reverse history search as Ctrl+R. The NORMAL-mode prompt also shows a hint about how to reach slash commands, which the Ctrl+R variant does not display. Press Esc to leave the search without submitting, or Enter to submit the highlighted match.

Any one of these options is enough to make the v2.1.191 behavior discoverable; combining the interactive-mode table update with a short note in Command history would cover both the keybinding reference and the prose walkthrough.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/interactive-mode | 151 | NORMAL-mode navigation table lists / only as reverse history search |
| https://code.claude.com/docs/en/interactive-mode | 220-238 | Reverse search with Ctrl+R describes the standard-mode search and never mentions the NORMAL-mode / variant or its v2.1.191 hint |
| https://code.claude.com/docs/en/keybindings | 465 | Vim mode interaction bullet says / is "the same as Ctrl+R" and omits the new slash-command hint |

Total scope: 2 pages affected

Source: Changelog v2.1.191

Exact changelog entry:

Improved vim mode prompt-history search (NORMAL /) to hint how to reach slash commands

Related context: The base /-opens-reverse-history-search behavior was added in v2.1.152, so the docs already describe that part correctly. v2.1.191 layered an additional user-visible hint on top of that existing flow, and the docs have not been updated to mention the new hint.