Skip to content

Commit 9675e90

Browse files
committed
docs(keybinds): note KEYTIMEOUT caveat for vv binding
1 parent 2fca0bd commit 9675e90

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

docs/keybinds.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -205,14 +205,16 @@ zsh runs in vi mode (from `oh-my-zsh/vi-mode`). Press `Esc` to enter normal mode
205205

206206
| Key | Action |
207207
|-----|--------|
208-
| `vv` | Edit command in `$EDITOR` |
208+
| `vv` | Edit command in `$EDITOR` *(see note below)* |
209209
| `e` | Edit command in vim *(custom)* |
210210
| Standard vi motions | `h/l` move cursor, `w/b/e` word movement, `0/$` line start/end, etc. |
211211
| `p` / `P` | Paste from clipboard |
212212
| `y` + motion | Yank to clipboard |
213213
| `d` + motion | Delete to clipboard |
214214
| `c` + motion | Change to clipboard |
215215

216+
> **Note on `vv`:** This requires two `v` keypresses within `$KEYTIMEOUT` milliseconds (zsh default: 40ms). With the default timeout it is nearly impossible to trigger reliably because the first `v` dispatches immediately to `visual-mode`. Raising `KEYTIMEOUT` to 15+ makes it usable. The `e` binding is provided as a single-keystroke alternative that avoids this issue entirely.
217+
216218
#### Insert mode
217219

218220
| Key | Action |

0 commit comments

Comments
 (0)