fzf-zsh-plugin
May 30, 2026 ยท View on GitHub
Table of Contents
ZSH plugin to enable using fzf to search command history and for files.
This will automagically install fzf into your home directory if it isn't already there, and bind ^R to an fzf-powered search of your command history.
Used by the zsh-quickstart-kit to make the default setup have a more 'batteries included' feel.
Yes, there is a plugin baked into oh-my-zsh, this allows easy fzf integration for other frameworks and shells, and adds some helper scripts.
Note - yes, these scripts could all be ZSH functions instead of scripts in the bin directory. We prefer to use standalone scripts so that non-ZSH users can also use the repository by adding its bin directory to their $PATH.
Contents
| Name | Description | Author |
|---|---|---|
apt-fzf-search | Filter apt-cache search results through fzf | linuxuprising.com |
asdf-fzf-install | Install one or more versions of the specified language with fzf and installs your selection with asdf | fzf wiki |
asdf-fzf-remove | Remove one or more versions of the specified language with fzf | fzf wiki |
asdf-fzf-uninstall | Select one or more versions of the specified language with fzf and uninstalls your selection with asdf | fzf wiki |
chrome-bookmark-browser | Rummages through your Chrome bookmarks with fzf and opens the selected bookmark(s) in your default browser | fzf wiki |
chrome-history | Browse Chrome history with fzf and open the selected entry | |
d-attach | Uses fzf to select docker containers to start and attach to. | From the fzf wiki |
d-image-rm | Uses fzf to select docker containers to start and attach to. | From the fzf wiki |
d-rm | Uses fzf to select docker containers to remove. | From the fzf wiki |
d-stop-container | Uses fzf to select a docker container to stop. | From the fzf wiki |
fif | Uses fzf and rg to find a term in files | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-brew-cask-install | Uses fzf to select programs to install (or show the home page) based on the output of brew cask search | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-brew-cask-uninstall | Uses fzf to select brew-installed programs to delete (or show the home page) | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-brew-install | Uses fzf to select programs to install based on the output of brew search | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-brew-uninstall | Uses fzf to select brew-installed programs to delete | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-brew-update | Uses fzf to select brew-installed programs to update | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-find-edit | Uses fzf to select files (displaying previews) to edit with $EDITOR | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-grep-edit | Uses fzf to select files (displaying previews) that contain a search term to edit with $EDITOR | Boost Your Command Line Productivity With Fuzzy Finder |
fzf-kill | Uses fzf to select processes to kill | Boost Your Command Line Productivity With Fuzzy Finder |
tm | Uses fzf to search for a tmux session or create one if no matches. | From the fzf wiki |
tmux-kill | Uses fzf to select a tmux session and kills it. | From the fzf wiki |
tmux-search | Uses fzf to select a tmux session. Skips fzf if there's only one match, exits if no match. | From the fzf wiki |
vagrant-box-search | Uses fzf to select a vagrant box and connect to it with ssh. | From the fzf wiki |
Installing
You probably want this plugin to be last in your framework's list of plugins to load. It dynamically generates $FZF_DEFAULT_OPT and $FZF_DEFAULT_COMMAND based on whether it sees things like rg and bat in your $PATH, so it should come after other plugins have had a chance to extend $PATH.
Zgenom
add zgenom load unixorn/fzf-zsh-plugin to your .zshrc with your other load commands.
Antigen
add antigen bundle unixorn/fzf-zsh-plugin to your .zshrc
Oh-My-Zsh
cd ~/.oh-my-zsh/custom/pluginsgit clone git@github.com:unixorn/fzf-zsh-plugin.git fzf-zsh- Add tumult to your plugin list - edit
~.zshrcand changeplugins=(...)toplugins=(... fzf-zsh)
Without using a framework
- git clone this repository, then add its bin directory to your
$PATH. - Add
source /path/to/repository/checkout/fzf-zsh-plugin.plugin.zshto your.zshrcfile.
The scripts in this collection don't actually require you to be using ZSH as your login shell, they're being distributed as an oh-my-zsh-compatible plugin because it's convenient for me.