Enable vim-mode scrollback keys in Grok Build

Vim-mode turns on bare-letter scrollback navigation (j/k, g/G, / search). Arrow keys and Page Up/Down still work with vim-mode off. Official: Modes and Commands, Keyboard Shortcuts, Settings reference.

Toggle in a session

/vim-mode

Or set it in user config:

[ui]
vim_mode = true

Default is false. Vim-mode applies to the scrollback, not the prompt editor. Prompt editing stays readline-style when [ui] simple_mode = true (the default); set simple_mode = false only if you want the experimental vim prompt keys.

Use it

1. Focus the scrollback with Tab.
2. Move with j / k (or ↓ / ↑).
3. Jump turns with Shift+L / Shift+H; responses with Shift+J / Shift+K.
4. Top / bottom: g / Shift+G. Half page: Ctrl+U / Ctrl+D.
5. Collapse / expand the selected entry: h / l. Expand or collapse all: e / Shift+E.
6. Search scrollback: / (vim mode). The Modes and Commands table also lists /find for conversation scrollback search.
7. Copy: y / Shift+Y. Open fullscreen viewer: Enter or Ctrl+F.

Open the live shortcut list with Ctrl+. (or Ctrl+X where Kitty keyboard protocol is missing).

Pitfalls

• Bare letters do nothing until scrollback is focused (Tab) and vim-mode is on.
• Terminal chords differ (VS Code-family, Apple Terminal, WezTerm). Check Keyboard Shortcuts → Terminal differences.
• /vim-mode is scrollback chrome. It does not change Plan / Auto / Always-approve session modes (Shift+Tab).