https://github.com/anoopkcn/fuzzy.nvim
A fast and lightweight Neovim plugin for fuzzy finding files, grepping code, and managing buffers using the quickfix list
https://github.com/anoopkcn/fuzzy.nvim
grep neovim neovim-plugin quickfix vim
Last synced: 24 days ago
JSON representation
A fast and lightweight Neovim plugin for fuzzy finding files, grepping code, and managing buffers using the quickfix list
- Host: GitHub
- URL: https://github.com/anoopkcn/fuzzy.nvim
- Owner: anoopkcn
- License: mit
- Created: 2025-11-21T12:01:16.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-12-14T04:20:36.000Z (2 months ago)
- Last Synced: 2025-12-16T05:34:18.208Z (about 2 months ago)
- Topics: grep, neovim, neovim-plugin, quickfix, vim
- Language: Lua
- Homepage:
- Size: 138 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fuzzy.nvim
For workflows using neovim's **quickfix lists**. `fuzzy.nvim` populates the quickfixlist with fuzzy search results for files, grep, buffers, etc.
## Features
- **`:FuzzyGrep` - Fast grep search** using `ripgrep` (fallback to `grep -R`)
- Equivalent to the default vim command `:copen | silent grep ` but smarter
- **`:FuzzyFiles` - File finding** using `fd` (fallback to `vim.fs.find`)
- **`:FuzzyBuffers` - Buffer switching** with fuzzy filtering
- **Full control** over search arguments via `ripgrep`/`fd` arguments
- **Explorer-friendly** execute commands with respect to current Explorer directory
## Requirements
- Neovim 0.11+
- (Optional) For best performance:
- [ripgrep](https://github.com/BurntSushi/ripgrep) (rg) - for `:FuzzyGrep` (fallback: `grep -R`)
- [fd](https://github.com/sharkdp/fd) - for `:FuzzyFiles` (fallback: `vim.fs.find`)
## Installation
### Using neovim native [vim.pack](https://neovim.io/doc/user/pack.html#vim.pack)
```lua
vim.pack.add({ src = "https://github.com/anoopkcn/fuzzy.nvim" })
require("fuzzy").setup()
```
### Using [lazy.nvim](https://github.com/folke/lazy.nvim)
```lua
{
'anoopkcn/fuzzy.nvim',
config = function()
require('fuzzy').setup()
end
}
```
## Configuration (optional)
```lua
require('fuzzy').setup({
open_single_result = false, -- Open single result directly (default: false)
file_match_limit = 600, -- Max files to show in FuzzyFiles (default: 600)
})
```
- **`open_single_result`** (boolean, default: `false`)
When enabled, `:FuzzyFiles` and `:FuzzyBuffers` will automatically open a single match instead of showing the quickfix list. Use the `!` modifier to override per-command.
- **`file_match_limit`** (number, default: `600`)
Maximum number of file results to display in the quickfix list.
## Commands
### `:FuzzyGrep[!] [pattern] [rg options]`
Search for patterns in files using ripgrep.
Alias: `:Grep`
Default behavior collapses multiple matches on the same line into a single quickfix entry. Add `!` to keep every match.
### `:FuzzyFiles[!] [fd arguments]`
Find files using fd.
Alias: `:Files`
Default behavior opens the quickfix list even if there's a single match. Add `!` to open the file directly if only one match is found.
### `:FuzzyBuffers[!] [pattern]`
List and filter open buffers.
Alias: `:Buffers`
Default behavior opens the quickfix list even if there's a single match. Add `!` to switch to the buffer directly if only one match is found.
### `:FuzzyList[!]`
Browse and select from quickfix list history.
Alias: `:List`
Default behavior shows all quickfix lists. Add `!` to show only lists created by fuzzy commands.
### `:FuzzyNext` / `:FuzzyPrev`
Navigate quickfix entries with cycling (wraps around at ends).
## Example Configuration
```lua
local fuzzy = require('fuzzy')
fuzzy.setup()
-- Grep
vim.keymap.set('n', '/', ':Grep ', { desc = 'Grep' })
-- Files
vim.keymap.set('n', 'ff', ':Files ', { desc = 'Find files' })
-- Buffers
vim.keymap.set('n', 'fb', ':Buffers! ', { desc = 'Switch buffer' })
-- Quickfix history
vim.keymap.set('n', 'fl', 'FuzzyList', { desc = 'Quickfix history' })
-- Grep word under cursor
vim.keymap.set('n', 'fw', function()
local word = vim.fn.expand('')
if word ~= '' then fuzzy.grep({ word }) end
end, { desc = 'Grep word' })
-- Grep WORD (literal)
vim.keymap.set('n', 'fW', function()
local word = vim.fn.expand('')
if word ~= '' then fuzzy.grep({ '-F', word }) end
end, { desc = 'Grep WORD (literal)' })
```
## API
### `fuzzy.setup(opts)`
Initialize the plugin with optional configuration.
### `fuzzy.grep(args, dedupe)`
Programmatically run a grep search.
- `args` (table|string) - Ripgrep arguments
- `dedupe` (boolean) - Collapse duplicate line matches (default: true)
```lua
fuzzy.grep({ 'TODO', '-t', 'lua' })
fuzzy.grep({ '-F', 'function(args)' }) -- literal search
```
## License
MIT
## Related Plugins
- [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim)
- [fzf-lua](https://github.com/ibhagwan/fzf-lua)