Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cloudhead/neovim-fuzzy

Minimalistic fuzzy file finding for neovim
https://github.com/cloudhead/neovim-fuzzy

fuzzy-search neovim neovim-plugin vim vim-plugin

Last synced: 23 days ago
JSON representation

Minimalistic fuzzy file finding for neovim

Awesome Lists containing this project

README

        

neovim-fuzzy

Fuzzy file finding for neovim, via fzy[1].

[1]: https://github.com/jhawthorn/fzy

. Rationale

To my knowledge, fzy delivers the best results out of all fuzzy finders,
including fzf, ctrl-p, command-t and unite. This is due to the advanced scoring
algorithm[2].

[2]: https://github.com/jhawthorn/fzy/blob/master/ALGORITHM.md

. Requirements

* neovim >= 0.1.5
* fzy
* rg[1] or ag[2] >= 0.33.0

[1]: https://github.com/BurntSushi/ripgrep
[2]: http://geoff.greer.fm/ag/

. Installation

Install `fzy` via your package manager, or check https://github.com/jhawthorn/fzy
for instructions.

If you're using vim-plug, add this to your vimrc:

Plug 'cloudhead/neovim-fuzzy'

You can also copy the contents of this directory into your .vim folder.

. Usage

Add something like this to your vimrc:

nnoremap :FuzzyOpen

Then hit to open the finder.

Once in the fzy finder:

close fzy pane
open selected file with default open command
open selected file in new horizontal split
open selected file in new vertical split
open selected file in new tab
next entry
previous entry

See the fzy documentation for the full list of key bindings.

neovim-fuzzy-specific keybindings can be disabled with:

let g:fuzzy_bindkeys = 0

Set your own keybindings for opening files in splits with:

autocmd FileType fuzzy tnoremap :FuzzyOpenFileInTab
autocmd FileType fuzzy tnoremap :FuzzyOpenFileInSplit
autocmd FileType fuzzy tnoremap :FuzzyOpenFileInVSplit

When no input is given, fuzzy shows the alternate buffer (also known as '#'),
followed by other open buffers, followed by all other files.

Fuzzy also lets you search within files, via the :FuzzyGrep command. You can
use it on its own, or pass it an expression to search.