diff options
| author | Yan Ivnitskiy <yan@users.noreply.github.com> | 2026-01-23 15:47:46 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-01-23 12:47:46 -0800 |
| commit | 73961adfa1e16847635fbccd6c6e20b97f74a637 (patch) | |
| tree | 22426ea4a4695d20a12360967f99bac42c767d84 /docs | |
| parent | chore!: remove total_history from api index response (#3094) (diff) | |
| download | atuin-73961adfa1e16847635fbccd6c6e20b97f74a637.zip | |
feat: add more vim movement bindings for navigation (#3041)
Add vim-style movement commands to vim_normal keymap mode:
- Ctrl+u/d: half-page up/down
- Ctrl+b/f: full-page up/down
- G: jump to visual bottom of history
- gg: jump to visual top of history (multi-key sequence)
- H/M/L: jump to top/middle/bottom of visible screen
Also adds `offset()` getter to ListState for H/M/L functionality, and
includes tests for the new bindings.
<!-- Thank you for making a PR! Bug fixes are always welcome, but if
you're adding a new feature or changing an existing one, we'd really
appreciate if you open an issue, post on the forum, or drop in on
Discord -->
## Checks
- [x] I am happy for maintainers to push small adjustments to this PR,
to speed up the review cycle
- [x] I have checked that there are no existing pull requests for the
same thing
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/docs/configuration/key-binding.md | 28 |
1 files changed, 22 insertions, 6 deletions
diff --git a/docs/docs/configuration/key-binding.md b/docs/docs/configuration/key-binding.md index 81e430f2..42940be2 100644 --- a/docs/docs/configuration/key-binding.md +++ b/docs/docs/configuration/key-binding.md @@ -234,12 +234,28 @@ $env.config = ( ### Vim mode If [vim is enabled in the config](config.md#keymap_mode), the following keybindings are enabled: -| Shortcut | Mode | Action | -| -------- | ------ | ------------------------------------- | -| k | Normal | Selects the next item on the list | -| j | Normal | Selects the previous item on the list | -| i | Normal | Enters insert mode | -| Esc | Insert | Enters normal mode | +| Shortcut | Mode | Action | +| -------- | ------ | ------------------------------------------ | +| k | Normal | Selects the next item on the list | +| j | Normal | Selects the previous item on the list | +| h | Normal | Move cursor left | +| l | Normal | Move cursor right | +| i | Normal | Enters insert mode | +| I | Normal | Move to start of line and enter insert | +| a | Normal | Move right and enter insert mode | +| A | Normal | Move to end of line and enter insert | +| Ctrl+u | Normal | Half-page up (toward visual top) | +| Ctrl+d | Normal | Half-page down (toward visual bottom) | +| Ctrl+b | Normal | Full-page up (toward visual top) | +| Ctrl+f | Normal | Full-page down (toward visual bottom) | +| G | Normal | Jump to visual bottom of history | +| gg | Normal | Jump to visual top of history | +| H | Normal | Jump to top of visible screen | +| M | Normal | Jump to middle of visible screen | +| L | Normal | Jump to bottom of visible screen | +| ? or / | Normal | Clear input and enter insert mode | +| 1-9 | Normal | Select item by number | +| Esc | Insert | Enters normal mode | ### Inspector |