fzf
A Fish shell plugin that adds mnemonic key bindings for fuzzy-finding files, git history, processes, and more using fzf.
What is fzf?
fzf.fish is a Fish shell plugin that integrates the fuzzy finder fzf to provide interactive search and insertion of files, git commits, shell history, processes, and variables directly into the command line. It solves the problem of cumbersome navigation and recall in terminal workflows by offering mnemonic key bindings and live previews.
Fish shell users who want to enhance their command-line productivity with fast, keyboard-driven fuzzy finding, particularly developers and system administrators who frequently work with files, git repositories, and shell history.
Developers choose fzf.fish for its seamless Fish integration, intuitive mnemonic key bindings, and comprehensive previews, offering a more efficient alternative to manual typing or other fzf plugins that may lack Fish-specific optimizations.
Overview
🔍🐟 Fzf plugin for Fish
Use Cases
Best For
- Fish shell users wanting faster file and directory navigation
- Git users needing to quickly browse commit history or status
- Terminal power users looking to search shell history interactively
- System administrators managing processes from the command line
- Developers exploring shell variables and their values
- Teams standardizing on Fish with consistent productivity plugins
Not Ideal For
- Users of other shells like Bash or Zsh who need cross-shell fzf integration
- Systems with minimal installation footprints where adding fzf, fd, and bat is prohibitive
- Teams already using other fzf plugins for Fish that would require uninstallation
- Environments relying on plugin managers other than Fisher for official support
Pros & Cons
Pros
Key bindings like Ctrl+Alt+F for files and Ctrl+Alt+L for git logs are designed for easy recall, aligning with the README's philosophy of mnemonic aids.
Includes live previews for files with syntax highlighting (via bat), git diffs, process info, and more, enhancing usability as shown in the examples.
Tightly integrated with Fish shell features, such as variable scope exploration and Fish command history with syntax highlighting, as detailed in the search commands.
Allows configuration of fzf options, preview commands, and listing behaviors through environment variables and functions, documented in the Configuration section.
Cons
Requires installation of fzf, fd, bat, and specific versions, adding complexity to setup and maintenance, as noted in the Installation table.
Explicitly incompatible with other fzf plugins for Fish, forcing users to remove alternatives, which can disrupt existing workflows, as warned in the README.
Only Fisher is officially supported; installation with other managers or manually is possible but not guaranteed, potentially leading to support gaps.
Frequently Asked Questions
Related Projects
FisherA plugin manager for Fish
nvmThe Node.js version manager you'll adore, crafted just for Fish
zPure-fish z directory jumping
VirtualfishFish shell tool for managing Python virtual environments
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.