ibhagwan/fzf-lua
Fzf Lua
fzf-lua is a fuzzy finder integration for Neovim that utilizes fzf to search files, buffers, and project symbols. It serves as a code navigation framework providing a dynamic result generator that populates search windows using real-time shell commands or custom Lua functions.
The project distinguishes itself through specialized integration tools for Git and Language Server Protocols. It includes a Git search interface for navigating commits, branches, stashes, and diffs, alongside an LSP integration tool that bridges language server providers to locate definitions and references across a codebase.
The plugin covers a broad range of capabilities including project-wide text searching via grep, workspace symbol discovery, and file navigation. It supports content rendering with syntax highlighting and item previews, as well as debugger state inspection for browsing session variables and breakpoints.
Performance is managed through asynchronous multiprocess shell wrapping to handle large file sets without freezing the editor thread.
Features
- File Filtering and Navigation - Provides high-performance fuzzy finding for quickly discovering and opening files and buffers in Neovim.
- Fuzzy Finder Integrations - Bridges shell commands and custom Lua functions with an interactive fzf fuzzy selection interface.
- Semantic Codebase Fetching - Queries language server providers to populate search lists with semantic codebase information.
- Symbol Search Interfaces - Queries language servers to map and locate workspace symbols, references, and definitions.
- File Search Utilities - Locates files within project directories using customizable patterns and exclusion rules.
- Fuzzy Search Interfaces - Implements a high-performance fuzzy search interface for locating files and open buffers.
- Git Object Browsers - Lists and searches through git files, commits, branches, stashes, and diffs.
- Version Control Browsers - Provides a specialized search interface for navigating git commits, branches, stashes, and diffs.
- Language Server Integrations - Provides deep integration with Language Server Protocols to retrieve semantic data like references and definitions.
- LSP Fuzzy Finders - Bridges language server protocols and fuzzy search interfaces to locate definitions and references.
- Neovim Plugins - Integrates the fzf fuzzy finder into Neovim to search files, buffers, and project symbols.
- Git Metadata Search - Provides searchable lists for navigating git commits, branches, stashes, and diffs.
- Project Search Tools - Implements project-wide text searching across directories and active buffers using a dedicated fuzzy-searchable interface.
- Symbol Navigation - Implements symbol navigation to locate definitions and references across a workspace using language server providers.
- Text Pattern Search - Ships a project-wide text search utility using grep with support for real-time live filtering.
- Standard Stream Piping - Pipes output from external shell commands into the fuzzy finder interface via standard streams.
- Asynchronous Process Managers - Executes heavy search operations in separate system processes to keep the Neovim editor thread responsive.
- Unified Data Searches - Merges results from multiple different pickers into a single unified search display.
- Dynamic Search Result Fetching - Implements dynamic fetching of search results that update in real-time based on user keystrokes.
- Real-time Result Generation - Populates search windows dynamically using real-time shell commands or custom Lua functions.
- Code Navigators - Serves as a framework for exploring codebase relationships and inserting selected symbols into buffers.
- Custom Picker Frameworks - Offers a framework for creating custom search pickers by executing shell commands and defining selection actions.
- Custom Key Mappings - Maps specific keys to internal commands or search actions to optimize navigation and workflow.
- Custom Selection Actions - Assigns custom functions or commands to be executed when an item is selected from a searchable list.
- Selection Content Previews - Displays the content of selected files using built-in tools or external pagers before opening them.
- Search Query Transformers - Allows users to define custom transformations for query strings before they are passed to the system shell.
- Preview Buffers - Uses temporary editor buffers to render selected items with native syntax highlighting and formatting.
- Dynamic Content Previews - Renders selected items inside a buffer using dynamic content generation for programmatic control.
- Live Preview Panels - Runs shell commands to provide live, interactive previews of selected items in a dedicated panel.
- Large Dataset Optimizations - Optimizes performance for large file sets using asynchronous multiprocess shell wrapping.
- Syntax Highlighting - Renders code with color-coded syntax highlighting directly within the search window using syntax parsers.
- Keyboard-to-Action Mappings - Maps keyboard inputs to internal Lua functions to perform complex editor operations upon selection.
- Fuzzy Finders - Lua-based FZF integration with async support.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
