Sneak is a Vim plugin that jumps to any location specified by two characters. It
works with multiple lines, operators (including repeat . and
surround), keymaps, visual mode, unicode ("multibyte"), and
macros.
- Preserves default
f,t,;and,behavior - Repeats operation with
. - Repeats motion with
;and, - Jumps immediately to the first match
- Updates the jumplist only for non-repeat motion
- Restricts to a vertical scope if count is used
- Provides label-mode for a minimalist
EasyMotion alternative:
let g:sneak#label = 1 - More at FAQ
Vim has many built-in motions, but "medium distance" is missing...
l f t % 'm } ]m ]] M L /
^
|
sneak
Sneak is invoked with s followed by exactly two characters:
s{char}{char}
- Press
sabto move the cursor immediately to the next instance of the text "ab".- Additional matches, if any, are highlighted until the cursor is moved.
- Press
;to go to the next match (orsagain, ifs_nextis enabled; see:help sneak). - Press
3;to skip to the third match from the current position. - Press
ctrl-oor``to go back to the starting point.- This is a built-in Vim motion; Sneak adds to Vim's jumplist
only on
sinvocation—not repeats—so you can abandon a trail of;or,by a singlectrl-oor``.
- This is a built-in Vim motion; Sneak adds to Vim's jumplist
only on
- Press
s<Enter>at any time to repeat the last Sneak-search. - Press
Sto search backwards.
Sneak can be scoped to a column of width 2×[number] by prefixing s
with a number.
- Press
5sxyto go immediately to the next instance of "xy" within 5 columns of the cursor.- A highlight block indicates the vertical scope.
Sneak is invoked with operators
via z (because s is taken by surround.vim).
- Press
3dzqtto delete up to the third instance of "qt".- Press
.to repeat the3dzqtoperation. - Press
2.to repeat twice. - Press
d;to delete up to the next match. - Press
4d;to delete up to the fourth next match.
- Press
- Press
ysz))]to surround in brackets up to)).- Press
;to go to the next)).
- Press
- Press
gUz\}to upper-case the text from the cursor until the next instance of the literal text\}- Press
.to repeat thegUz\}operation.
- Press
- vim-plug
Plug 'justinmk/vim-sneak'
- Pathogen
cd ~/.vim/bundle && git clone git://github.com/justinmk/vim-sneak.git
- Manual installation:
- Copy the files to your
.vimdirectory.
- Copy the files to your
To repeat Sneak operations (like dzab) with dot .,
repeat.vim is required.
For the same reason that Vim has motions
like f and t: common operations should use as few keystrokes as possible.
/ab<cr>requires 33% more keystrokes thansab- sets only the initial position in the Vim jumplist—so you can explore a
trail of matches via
;, then return to the start with a singlectrl-oor`` - doesn't clutter your search history
- input is always literal (no need to escape special characters)
- ignores accents ("equivalence class") when matching (#183)
- smarter, subtler highlighting
- sneak label-mode
- Sneak is fifty times more precise than
fort - Sneak moves vertically
- Sneak highlights matches in the direction of your search
You can specify any mapping for Sneak (see :help sneak).
By the way: cl is equivalent to s, and cc is equivalent to S.
nmap f <Plug>Sneak_s
nmap F <Plug>Sneak_S
xmap f <Plug>Sneak_s
xmap F <Plug>Sneak_S
omap f <Plug>Sneak_s
omap F <Plug>Sneak_S
Sneak provides <Plug> convenience-mappings for f and t 1-character-sneak.
These mappings do not invoke label-mode, even if you have it enabled.
"replace 'f' with 1-char Sneak
nmap f <Plug>Sneak_f
nmap F <Plug>Sneak_F
xmap f <Plug>Sneak_f
xmap F <Plug>Sneak_F
omap f <Plug>Sneak_f
omap F <Plug>Sneak_F
"replace 't' with 1-char Sneak
nmap t <Plug>Sneak_t
nmap T <Plug>Sneak_T
xmap t <Plug>Sneak_t
xmap T <Plug>Sneak_T
omap t <Plug>Sneak_t
omap T <Plug>Sneak_T
Copyright © Justin M. Keyes. Distributed under the MIT license.