Cheat Sheet logoCheat Sheet Today

fzf Install, Upgrade, and Shell Integration

fzf•Permalink

Install fzf, enable shell integration, and configure global defaults for day-to-day use.

Sign in to save
View
StandardDetailedCompact
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
## Install and verify
Install with Homebrew
↗#
brew install fzf

# Install fzf on macOS or Linux with Homebrew.

Install with apt
↗#
sudo apt-get install -y fzf

# Install fzf from Debian or Ubuntu repositories.

Install with pacman
↗#
sudo pacman -S fzf

# Install fzf on Arch Linux.

Install from the upstream repository
↗#
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

# Clone the repo and run the installer for shell integration.

Check the installed version
↗#
fzf --version

# Print the current fzf version.

Open the embedded manual
↗#
fzf --man

# Show the built-in man page from the binary.

## Shell integration
Source zsh integration
↗#
[ -f ~/.fzf.zsh ] && source ~/.fzf.zsh

# Load fzf key bindings and completion in zsh.

Source bash integration
↗#
[ -f ~/.fzf.bash ] && source ~/.fzf.bash

# Load fzf key bindings and completion in bash.

Set a better default file source
↗#
export FZF_DEFAULT_COMMAND='fd --type f --hidden --follow --exclude .git'

# Use fd instead of find for faster file listings.

Define global default options
↗#
export FZF_DEFAULT_OPTS='--height=40% --layout=reverse --border --info=inline'

# Apply common options to every fzf invocation.

Customize CTRL-T picker
↗#
export FZF_CTRL_T_OPTS='--preview "bat --style=numbers --color=always --line-range :200 {}"'

# Tune the file picker bound to CTRL-T.

More in fzf

fzf tmux, Editor Integration, Troubleshooting, and Performance
Use fzf with tmux and editors, and fix common issues involving shell integration, source commands, and large repositories.
fzf Reload, Event Bindings, and Dynamic Sources
Build live search interfaces with reload, change events, refresh-preview, and mode-switching key bindings.
fzf Recipes: Files, ripgrep, Git, Processes, and Navigation
Practical pipeline recipes that combine fzf with fd, ripgrep, bat, Git, and shell utilities.
fzf Shell Completion and Key Bindings
Set up fuzzy shell completion and customize built-in key bindings like CTRL-T, CTRL-R, and ALT-C.
fzf Layout, UI, and Styling
Tune layout, borders, headers, sorting, and visual style for cleaner fuzzy-finder interfaces.
fzf Preview Windows, Key Bindings, and Actions
Use previews, key bindings, execute actions, and dynamic UI changes to build powerful interactive pickers.

Recommended next

No recommendations yet.
Browse all sheets →