nvim-lspfuzzy
A Neovim plugin that integrates FZF with the Language Server Protocol client for fuzzy-finding LSP results.
What is nvim-lspfuzzy?
nvim-lspfuzzy is a Neovim plugin that bridges the Language Server Protocol client with the FZF fuzzy finder. It replaces default LSP handlers to display results like definitions, references, and diagnostics in FZF's interactive interface, solving the problem of cumbersome navigation through traditional quickfix lists.
Neovim users who rely on LSP for code intelligence and prefer FZF for its fuzzy-finding capabilities, particularly developers working in large codebases who need efficient navigation.
Developers choose nvim-lspfuzzy because it combines the power of LSP with the speed and flexibility of FZF, offering a more intuitive and keyboard-driven workflow for exploring code compared to built-in LSP UIs.
Overview
A Neovim plugin to make the LSP client use FZF
Use Cases
Best For
- Navigating to definitions and references in large codebases with fuzzy search
- Listing and filtering LSP diagnostics (errors/warnings) across multiple buffers
- Exploring workspace symbols with a fuzzy-finding interface
- Customizing LSP result navigation with split/tab actions
- Enhancing Neovim's LSP client with FZF's preview capabilities
- Replacing quickfix lists with interactive FZF menus for LSP operations
Not Ideal For
- Developers who prefer Telescope or other fuzzy finders over FZF for Neovim LSP integration
- Projects relying on Neovim's default LSP UI for seamless compatibility with other plugins or quickfix-based workflows
- Environments where minimizing external dependencies is critical, as it requires FZF and optional fzf.vim
Pros & Cons
Pros
Replaces default LSP handlers with FZF's fuzzy-finding interface, making it faster and more intuitive to search through definitions, references, and diagnostics compared to quickfix lists.
Supports configurable FZF actions for splits and tabs, such as ctrl-v for vertical splits, enhancing workflow flexibility directly from the search interface.
Can be limited to specific LSP methods via the 'methods' option, preventing unnecessary FZF pop-ups for operations like diagnostics if not needed.
Optional fzf.vim integration enables code previews in FZF, providing context without leaving the interface, though it requires additional setup.
Cons
Requires FZF and optionally fzf.vim, adding external dependencies that may not be available in all setups and tying the plugin to a specific fuzzy finder.
Setup involves Lua configuration and handling Neovim version-specific code (e.g., for 0.11+), which can be complex and error-prone for users unfamiliar with Neovim's LSP client.
Redefining LSP handlers might interfere with other plugins that modify LSP behavior, as noted in the README's troubleshooting for preview and modifier issues.
Frequently Asked Questions
Related Projects
nvim-lspconfigQuickstart configs for Nvim LSP
lspsaga.nvimimprove neovim lsp experience
none-ls.nvimnull-ls.nvim reloaded / Use Neovim as a language server to inject LSP diagnostics, code actions, and more via Lua.
rustaceanvim🦀 Supercharge your Rust experience in Neovim! A heavily modified fork of rust-tools.nvim
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.