[DOCS] Vim editor mode docs omit visual and visual-line modes

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

The "Vim editor mode" reference, plus related Vim capability summaries in Terminal config and the status line schema.

Current Documentation

The docs currently describe Vim mode as a two-mode feature and do not mention visual selections:

## Vim editor mode Enable vim-style editing via /config → Editor mode. ### Mode switching | Esc | Enter NORMAL mode | INSERT | | i | Insert before cursor | NORMAL | | I | Insert at beginning of line | NORMAL | | a | Insert after cursor | NORMAL | | A | Insert at end of line | NORMAL | | o | Open line below | NORMAL | | O | Open line above | NORMAL |

The terminal config page lists the supported subset without v or V:

The supported subset includes: Mode switching: Esc (to NORMAL), i/I, a/A, o/O (to INSERT) Navigation: h/j/k/l, w/e/b, 0/$/^, gg/G, f/F/t/T with ;/, repeat * Editing: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repeat)

The status line schema also says Vim mode only reports two states:

vim.mode | Current vim mode (NORMAL or INSERT) when vim mode is enabled

What's Wrong or Missing?

Claude Code v2.1.118 added vim visual mode (v) and visual-line mode (V) with selection support, operators, and visual feedback, but the current docs still describe Vim mode as if it only has NORMAL and INSERT states.

That leaves the docs missing the user-facing behavior needed to discover and use the feature:

• how to enter visual and visual-line mode
• how selections behave in those modes
• which operators work on visual selections
• whether related references that describe vim.mode or the supported Vim subset now include additional modes

Suggested Improvement

Update the Vim documentation to match v2.1.118:

1. Expand the "Vim editor mode" section in Interactive mode with visual mode (v) and visual-line mode (V).
2. Add a short explanation of selection behavior, visual feedback, and how operators apply to active selections.
3. Update Terminal config's "supported subset" list so it includes the new visual capabilities.
4. Review the status line docs and document any additional vim.mode values if visual modes are exposed there.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/interactive-mode | Primary Vim editor mode reference |
| https://code.claude.com/docs/en/terminal-config | Summary of the supported Vim subset |
| https://code.claude.com/docs/en/statusline | vim.mode schema description |

Total scope: 3 pages affected

Source: Changelog v2.1.118

Exact changelog entry: Added vim visual mode (v) and visual-line mode (V) with selection, operators, and visual feedback