Fork me on GitHub


A community-driven vim distribution

Home | About | Documentation | Development | Community | Sponsors

Asynchronous grep on the fly

FlyGrep means grep on the fly, it will update the result as you type. Of course, it is running asynchronously. Before using this feature, you need to install a searching tool. FlyGrep works through search tools: ag, rg, ack, pt and grep, Choose one you like.

This ia a built-in plugin in SpaceVim, and we also separated a plugin : FlyGrep.vim


In SpaceVim, you can use SPC s p or SPC s / to search in the current project.

searching project

You can use SPC s s to search in the current file. To search word under the cursor, you can press SPC s S.

searching current file

To searching in all loaded buffers, you need to press SPC s b, and you can also use SPC s B to search word under the point.


If you want to searching in a different directory instead of current directory, you can use SPC s f. Then insert the path of the arbitrary directory.

If you need background searching, you can press SPC s j, after searching is done, the index will be displayed on statusline. you can use SPC s l to list all the search results.

Key bindings

The search commands in SpaceVim are organized under the SPC s prefix with the next key is the tool to use and the last key is the scope. For instance SPC s a b will search in all opened buffers using ag.

If the last key (determining the scope) is uppercase then the current word under the cursor is used as default input for the search. For instance SPC s a B will search with word under cursor.

If the tool key is omitted then a default tool will be automatically selected for the search. This tool corresponds to the first tool found on the system of the list g:spacevim_search_tools, the default calling sequence is rg, ag, pt, ack then grep. For instance SPC s b will search in the opened buffers using pt if rg and ag have not been found on the system.

The tool keys are:

Tool Key
ag a
grep g
ack k
rg r
pt t

The available scopes and corresponding keys are:

Scope Key
opened buffers b
files in a given directory f
current project p

Within FlyGrep buffer:

Key Binding Description
<Esc> close FlyGrep buffer
<Enter> open file at the cursor line
<Tab> move cursor line down
<C-j> move cursor line down
<S-Tab> move cursor line up
<C-k> move cursor line up
<Bs> remove last character
<C-w> remove the word before the cursor
<C-u> remove the line before the cursor
<C-k> remove the line after the cursor
<C-a>/<Home> Go to the beginning of the line
<C-e>/<End> Go to the end of the line

Hosted on GitHub, Help improve this page — Theme by mattgraham,