OpenCode Vim

opencode fork with vim mode. Syncs with upstream releases.

Install

# npm
npm i -g @leohenon/ocv

# Homebrew
brew install leohenon/tap/ocv

# curl
curl -fsSL https://raw.githubusercontent.com/leohenon/opencode-vim/ocv/install.sh | sudo sh

Usage

ocv

Update

# npm
npm i -g @leohenon/ocv@latest

# Homebrew
brew upgrade ocv

# built-in updater
ocv update

Features

Vim motions

Toggle via command palette (Ctrl+p -> Toggle vim mode).

Unicode word boundaries are not supported.

Category	Keys
Character / word	h, j, k, l, w, b, e, W, B, E
Line / buffer	0, ^, _, $, gg, G
Matching / paragraph	%, {, }
Find / till	f, F, t, T, ;, ,
Scroll	Ctrl+e, Ctrl+y, Ctrl+d, Ctrl+u, Ctrl+f, Ctrl+b
Insert / replace	i, I, a, A, o, O, R
Character / line edit	r, x, ~, s, S, J, C, dd, cc
Word changes	cw, cb, ciw, caw, ciW, caW
Word deletes	dw, db, diw, daw, diW, daW
Quote changes	ci", ca", ci', ca', ci` , ca`
Quote deletes	di", da", di', da', di` , da`
Bracket changes	ci(, ca(, ci[, ca[, ci{, ca{, ci<, ca<
Bracket deletes	di(, da(, di[, da[, di{, da{, di<, da<
Find / till operators	cf, cF, ct, cT, df, dF, dt, dT
Matching / paragraph operators	c%, d%, c}, c{, d}, d{
Line / word yanks	yy, yw, yiw, yaw, yiW, yaW
Quote yanks	yi", ya", yi', ya', yi` , ya`
Bracket yanks	yi(, ya(, yi[, ya[, yi{, ya{, yi<, ya<
Matching / paragraph yanks	y%, y}, y{
Put / undo / repeat	p, P, u, Ctrl+r, .
Visual selection	v, V

Note

<leader>y copies the prompt selection when present; configure it with keybinds.prompt_copy_selection. For clipboard sync, see System clipboard register.

Anthropic OAuth

Claude subscriptions built-in with /connect. No plugins or configuration needed.

Copy Mode

Text selection from the chat session view.

Copy mode collapses code diffs into a single column for easy copying.

• Enter copy mode with <leader>v or Ctrl+W k.
• Navigate with h j k l or arrow keys (Left Down Up Right).
• Press v / V to start character-wise or line-wise selection.
• y/yy yanks to the vim register.
• Enter copies to the system clipboard.
• Y yanks to the vim register and scrolls to the bottom.
• Shift+Enter copies to the system clipboard and scrolls to the bottom.
• Escape exits visual mode, q exits copy mode and scrolls to the bottom.
• Ctrl+W j exits copy mode without scrolling; Ctrl+W w toggles copy mode.
• i focuses the prompt input in insert mode without scrolling.
• z zt zz zb adjust copy-mode scroll positioning.
• H / M / L jump to the top / middle / bottom of the viewport.

Tip

Configure the entry key with keybinds.copy_mode.

Prompt Input

Prompt input height is configurable with prompt_max_height in tui.json.

A scrollbar appears when the prompt exceeds the visible area. gg / G focus the prompt input when typing.

{
  "prompt_max_height": 35,
  "prompt_scrollbar": true
}

Note: Setting prompt_max_height above 40 is not recommended.

Minimal UI

Hides extra UI hints and tips.

Default	Minimal

Toggle via command palette (Ctrl+p -> Toggle minimal ui).

Configuration

Submit behavior

By default, vim insert mode keeps Enter for newlines and normal mode uses Enter to submit. If you want Enter to submit from insert mode too, add this to tui.json:

{
  "vim_enter_submit": true
}

When vim_enter_submit is enabled, line returns are still available through input_newline.

{
  "keybinds": {
    "input_newline": "alt+return"
  }
}

If you keep vim_enter_submit disabled but want a separate submit key that works from insert mode, configure input_force_submit:

{
  "keybinds": {
    "input_force_submit": "alt+return"
  }
}

By default, input_force_submit is unbound.

System clipboard register

By default, vim mode uses an internal register for y and p. If you want yank and paste to use the system clipboard instead, add this to tui.json:

{
  "vim_system_clipboard_register": true
}

With this enabled, yank operations sync to the system clipboard and p / P paste from it.

Note

Terminal/OS clipboard shortcuts don’t preserve Vim linewise register state. External clipboard text is pasted as characterwise text.

Feedback

Have a suggestion? Open an issue.

Contributors

Thanks to everyone who contributed.