Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] Vim editor mode docs omit visual and visual-line modes [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#52188•Fetched 2026-04-23 07:34:15
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×3
RAW_BUFFERClick to expand / collapse

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:

PageContext
https://code.claude.com/docs/en/interactive-modePrimary Vim editor mode reference
https://code.claude.com/docs/en/terminal-configSummary of the supported Vim subset
https://code.claude.com/docs/en/statuslinevim.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

extent analysis

TL;DR

Update the Vim documentation to include visual mode (v) and visual-line mode (V) features introduced in Claude Code v2.1.118.

Guidance

  • Review the current documentation for "Vim editor mode" and update it to reflect the addition of visual and visual-line modes.
  • Add explanations for how to enter these modes, selection behavior, visual feedback, and applicable operators.
  • Update the Terminal config page to include v and V in the supported Vim subset.
  • Verify if the status line schema needs updates to reflect the new vim.mode values for visual modes.

Example

No code snippet is necessary for this documentation update, but the revised "Vim editor mode" section could include a table similar to the existing one, with additional rows for v and V modes:

### Mode switching
| Key  | Action                  | Resulting Mode |
|------|-------------------------|---------------|
| `Esc`| Enter NORMAL mode       | NORMAL        |
| `i`  | Insert before cursor    | INSERT        |
| ...  | ...                     | ...           |
| `v`  | Enter visual mode       | VISUAL        |
| `V`  | Enter visual-line mode   | VISUAL LINE   |

Notes

The update should ensure consistency across the affected pages, including the primary Vim editor mode reference, Terminal config summary, and status line schema description.

Recommendation

Apply workaround: Update the documentation as suggested to reflect the current features and behavior of Vim mode in Claude Code v2.1.118, ensuring users can effectively use the visual and visual-line modes.

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…
#prompt formatting#chain error#conversation history#tool integration#LLM response

Still need to ship something?

×6

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

Back to top recommendations

TRENDING