Fuzzy picker & vim.ui.select implementation via fzy for neovim
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Mathias Fussenegger cc41ba47d2 Don't set border for float window
To have it use new (in nvim 0.11) `winborder` global
2025-03-26 20:16:29 +01:00
.github Update super-linter to slim@v4 2021-12-22 13:59:13 +01:00
demo Add demo to readme 2020-10-16 19:09:26 +02:00
doc Remove deprecated functions 2022-11-18 22:16:17 +01:00
lua Don't set border for float window 2025-03-26 20:16:29 +01:00
plugin Split pickers out into nvim-qwahl 2022-10-23 18:08:10 +02:00
.editorconfig Add editorconfig file 2020-10-22 22:43:08 +02:00
.gitignore Initial commit 2020-10-14 19:08:11 +02:00
.luacheckrc Fix deprecation warnings 2024-05-27 18:50:12 +02:00
LICENSE Initial commit 2020-10-14 19:08:11 +02:00
README.md Expose command function 2023-04-21 14:31:45 +02:00

nvim-fzy

A vim.ui.select implementation for the fzy CLI.

Installation

  • Requires Neovim (latest stable or nightly)
  • Install fzy and make sure it is in your $PATH.
  • nvim-fzy is a plugin. Install it like any other plugin:
    • If using vim-plug: Plug 'mfussenegger/nvim-fzy'
    • If using packer.nvim: use 'mfussenegger/nvim-fzy'

Usage

nvim-fzy provides the vim.ui.select implementation and a execute function to feed the output of commands to fzy.

Create some mappings like this:

lua fzy = require('fzy')
nnoremap <silent><leader>ff :lua fzy.execute('fd', fzy.sinks.edit_file)<CR>
nnoremap <silent><leader>fg :lua fzy.execute('git ls-files', fzy.sinks.edit_file)<CR>
nnoremap <silent><leader>fl :lua fzy.execute('ag --nobreak --noheading .', fzy.sinks.edit_live_grep)<CR>

See :help fzy for more information

demo

To get additional pickers to jump to tags and other stuff, you can use it in combination with nvim-qwahl

Enjoy

Customize

  • You can override the new_pop function if you want to customize the floating window.
  • You can override the command function if you want to customize the fzy shell command.

Take a look at the source to see the default implementations.

Goals

  • Have a simple API so people can create their custom actions.
  • Include the essentials, but not much more than that.

This plugin is pretty much done and won't see feature additions, unless there is a convincing case to be made.

Alternatives