fzf Cheatsheet

# Debian / Ubuntu
sudo apt install fzf

# RHEL family, Fedora (the package is in the Fedora repositories, on RHEL it may need EPEL)
sudo dnf install fzf

# macOS (Homebrew)
brew install fzf

# Any Linux or macOS, from source
git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

fzf --version

# ~/.bashrc  (fzf 0.48.0 or newer)
eval "$(fzf --bash)"

# ~/.zshrc   (fzf 0.48.0 or newer)
source <(fzf --zsh)

# ~/.config/fish/config.fish
fzf --fish | source

# Older fzf (below 0.48.0), installed with the git installer (it writes ~/.fzf.bash)
[ -f ~/.fzf.bash ] && source ~/.fzf.bash

# Older fzf installed from a package: source the file that the package ships (see section 1)
[ -f /usr/share/fzf/shell/key-bindings.bash ] && source /usr/share/fzf/shell/key-bindings.bash                 # RHEL 8, 9, 10 (EPEL)
[ -f /usr/share/doc/fzf/examples/key-bindings.bash ] && source /usr/share/doc/fzf/examples/key-bindings.bash   # Ubuntu 22.04, 24.04

fzf --preview 'cat {}' --bind 'ctrl-/:toggle-preview'   # CTRL-/ shows and hides the preview
fzf --bind 'enter:become(vim {})'                        # ENTER replaces fzf with vim on the chosen file
fzf --bind 'ctrl-o:execute(less {})'                     # CTRL-O opens less, then returns to fzf
fzf --bind 'ctrl-r:reload(ls)'                           # CTRL-R replaces the list with new output

# ~/.bashrc
export FZF_DEFAULT_OPTS='--height 40% --layout=reverse --border'
export FZF_DEFAULT_COMMAND="find . -type f -not -path '*/.git/*'"
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"      # CTRL-T does not read FZF_DEFAULT_COMMAND

fzf --color=light            # built-in schemes: dark (default), light, base16 (the terminal's 16 colors), bw
fzf --style=full:rounded     # style presets (fzf 0.58+): default, minimal, full[:border style]
fzf --color=dark,hl:#ff5f87,pointer:#ff5f87   # a base scheme with single elements changed

# Dracula (github.com/dracula/fzf)
export FZF_DEFAULT_OPTS="$FZF_DEFAULT_OPTS --color=fg:#f8f8f2,bg:#282a36,hl:#bd93f9 --color=fg+:#f8f8f2,bg+:#44475a,hl+:#bd93f9 --color=info:#ffb86c,prompt:#50fa7b,pointer:#ff79c6 --color=marker:#ff79c6,spinner:#ffb86c,header:#6272a4"

# Catppuccin Mocha (github.com/catppuccin/fzf, also Latte, Frappé and Macchiato)
export FZF_DEFAULT_OPTS="$FZF_DEFAULT_OPTS --color=bg+:#313244,bg:#1E1E2E,spinner:#F5E0DC,hl:#F38BA8 --color=fg:#CDD6F4,header:#F38BA8,info:#CBA6F7,pointer:#F5E0DC --color=marker:#B4BEFE,fg+:#CDD6F4,prompt:#CBA6F7,hl+:#F38BA8 --color=selected-bg:#45475A --color=border:#6C7086,label:#CDD6F4"

alias fm='fzf --multi'                                   # TAB marks rows, one per line on output

# fp: file picker with preview (bat, batcat, or the first 50 lines)
alias fp="fzf --preview 'if command -v bat >/dev/null; then bat --color=always --style=numbers {}; elif command -v batcat >/dev/null; then batcat --color=always --style=numbers {}; else head -n 50 {}; fi'"

alias fgl="git log --oneline --color=always | fzf --ansi --preview 'git show --color=always {1}'"   # browse commits

# fhelp: list the aliases and functions of this cheatsheet, ENTER prints the chosen name
alias fhelp='printf "%s\n" \
  "fm               alias      fzf --multi, multi-select" \
  "fp               alias      file picker with a bat or batcat preview" \
  "fgl              alias      browse commits with a diff preview" \
  "fe [query]       function   open a file in EDITOR" \
  "fcd [dir]        function   cd into a subdirectory" \
  "fgb              function   check out a local or remote branch" \
  "fga              function   stage picked files" \
  "fgc [message]    function   stage everything and commit, after a yes/no check" \
  "fgs              function   browse stashes" \
  "faws             function   pick an AWS profile and export AWS_PROFILE" \
  "fkc              function   switch the kubectl context" \
  "fssh             function   connect to a host from ~/.ssh/config" \
  "fport            function   list listening TCP ports" \
  "fsys [action]    function   systemd service: status, logs, restart, ..." \
  "fjl [priority]   function   search the journal of this boot" \
  "fenv             function   look up an environment variable" \
  "fman [query]     function   open a man page" \
  "fdl              function   follow the logs of a container" \
  "fdx              function   open a shell in a container" \
  "fds              function   stop containers" \
  | fzf --no-sort --header "fzf aliases and functions" | awk "{print \$1}"'

# fe [query]: open the chosen file in $EDITOR
fe() { local f; f=$(fzf --query "$1" --select-1 --exit-0) && [ -n "$f" ] && ${EDITOR:-vim} "$f"; }

# fcd [dir]: cd into a subdirectory
fcd() { local d; d=$(command find "${1:-.}" -type d -not -path '*/.git/*' 2>/dev/null | fzf) && [ -n "$d" ] && cd "$d"; }

# fgb: check out a branch (local or remote)
fgb() {
  local b
  b=$(git branch --all | grep -v HEAD | sed 's#^[* ]*##; s#^remotes/[^/]*/##' | sort -u | fzf) && [ -n "$b" ] && git checkout "$b"
}

# fga: stage files picked from the modified and untracked ones (TAB for several)
fga() {
  local sel f files=()
  sel=$(git ls-files --modified --others --exclude-standard | sort -u | fzf -m) || return
  while IFS= read -r f; do [ -n "$f" ] && files+=("$f"); done <<< "$sel"
  [ "${#files[@]}" -gt 0 ] && git add -- "${files[@]}" && git status --short
}

# fgc [message]: stage ALL changes (modified, deleted, new and untracked) and commit them, after a yes/no check
fgc() {
  local msg="$*" answer
  git rev-parse --is-inside-work-tree >/dev/null 2>&1 || { echo "not in a git repo" >&2; return 1; }
  [ -n "$(git status --porcelain)" ] || { echo "nothing to commit"; return 0; }
  git status --short
  if [ -z "$msg" ]; then printf 'Commit message: '; IFS= read -r msg; fi
  [ -n "$msg" ] || { echo "empty message, nothing done" >&2; return 1; }
  answer=$(printf 'yes\nno\n' | fzf --height 20% --header "Stage ALL changes above and commit \"$msg\"?")
  [ "$answer" = yes ] && git add -A && git commit -m "$msg"
}

# fgs: pick a stash and show it (use "git stash apply <name>" to restore)
fgs() {
  local s
  s=$(git stash list | fzf --preview 'git stash show -p --color=always $(echo {} | cut -d: -f1)' | cut -d: -f1) \
    && [ -n "$s" ] && git stash show -p --color=always "$s"
}

# faws: pick an AWS CLI profile and export it for this shell
faws() {
  local p
  p=$(aws configure list-profiles | fzf --header 'AWS_PROFILE') && [ -n "$p" ] && export AWS_PROFILE="$p" && echo "AWS_PROFILE=$p"
}

# fkc: switch the current kubectl context (this edits your kubeconfig for every terminal)
fkc() { local c; c=$(kubectl config get-contexts -o name | fzf --header 'kubectl context') && [ -n "$c" ] && kubectl config use-context "$c"; }

# fssh: pick a host from ~/.ssh/config and connect
fssh() {
  local h
  h=$(awk 'tolower($1)=="host" { for (i=2; i<=NF; i++) if ($i !~ /[*?!]/) print $i }' ~/.ssh/config 2>/dev/null | sort -u | fzf --header 'ssh host') \
    && [ -n "$h" ] && ssh "$h"
}

# fport: list listening TCP ports and print the chosen line (PID is column 2)
fport() { lsof -nP -iTCP -sTCP:LISTEN 2>/dev/null | sed 1d | fzf --header 'COMMAND PID ... NAME'; }

# fsys [action]: pick a systemd service; status by default, "logs" follows its journal,
# any other systemctl action (start, stop, restart, enable, disable, ...) runs with sudo
fsys() {
  local act=${1:-status} u
  u=$( { systemctl list-units --type=service --all --no-legend --plain | awk '$2 != "not-found" {print $1}'
         systemctl list-unit-files --type=service --no-legend | awk '{print $1}'; } \
       | grep -v '@\.service$' | sort -u \
       | fzf --header "systemctl $act" --preview 'SYSTEMD_COLORS=1 systemctl status --no-pager {}') || return
  [ -n "$u" ] || return
  case $act in
    status) systemctl status --no-pager "$u" ;;
    logs)   journalctl -u "$u" -f -n 100 ;;
    *)      if [ "$(id -u)" -eq 0 ]; then systemctl "$act" "$u"; else sudo systemctl "$act" "$u"; fi ;;
  esac
}

# fjl [priority]: search this boot's journal at <priority> or worse (default warning), newest first
fjl() { journalctl -b -p "${1:-warning}" -o short-iso --no-pager | fzf -m --tac --no-sort --header "journal, ${1:-warning} and worse"; }

# fenv: pick an exported environment variable and print its value
fenv() {
  local v
  v=$(env | sed -n 's/^\([A-Za-z_][A-Za-z0-9_]*\)=.*/\1/p' | sort -u | fzf --preview 'printenv {}') && [ -n "$v" ] && printenv "$v"
}

# fman [query]: pick a man page from "man -k" with a preview, then open it
fman() {
  local sel name sec
  sel=$(man -k . 2>/dev/null | fzf --query "$1" \
          --preview 'man "$(echo {} | sed -E "s/^[^(]*\(([^)]*)\).*/\1/")" "$(echo {} | sed -E "s/^ *([^ ,(]+).*/\1/")" 2>/dev/null') || return
  [ -n "$sel" ] || return
  name=$(echo "$sel" | sed -E 's/^ *([^ ,(]+).*/\1/')
  sec=$(echo "$sel" | sed -E 's/^[^(]*\(([^)]*)\).*/\1/')
  man "$sec" "$name"
}

# _fdc: pick running containers and print their names (helper for fdl, fdx, fds)
_fdc() { docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}' | fzf "$@" | cut -f1; }

# fdl: follow the logs of a container
fdl() { local c; c=$(_fdc) && [ -n "$c" ] && docker logs -f --tail 100 "$c"; }

# fdx: open a shell in a container, bash if it exists, else sh
fdx() { local c; c=$(_fdc) && [ -n "$c" ] && docker exec -it "$c" sh -c 'command -v bash >/dev/null && exec bash || exec sh'; }

# fds: stop containers (TAB for several)
fds() { local sel c cs=(); sel=$(_fdc -m) || return; while IFS= read -r c; do [ -n "$c" ] && cs+=("$c"); done <<< "$sel"; [ "${#cs[@]}" -gt 0 ] && docker stop "${cs[@]}"; }

# ---- fzf aliases and functions, works in bash and zsh ----

# ---- aliases ----
alias fm='fzf --multi'                                   # TAB marks rows, one per line on output
# fp: file picker with preview (bat, batcat, or the first 50 lines)
alias fp="fzf --preview 'if command -v bat >/dev/null; then bat --color=always --style=numbers {}; elif command -v batcat >/dev/null; then batcat --color=always --style=numbers {}; else head -n 50 {}; fi'"
alias fgl="git log --oneline --color=always | fzf --ansi --preview 'git show --color=always {1}'"   # browse commits
# fhelp: list the aliases and functions of this cheatsheet, ENTER prints the chosen name
alias fhelp='printf "%s\n" \
  "fm               alias      fzf --multi, multi-select" \
  "fp               alias      file picker with a bat or batcat preview" \
  "fgl              alias      browse commits with a diff preview" \
  "fe [query]       function   open a file in EDITOR" \
  "fcd [dir]        function   cd into a subdirectory" \
  "fgb              function   check out a local or remote branch" \
  "fga              function   stage picked files" \
  "fgc [message]    function   stage everything and commit, after a yes/no check" \
  "fgs              function   browse stashes" \
  "faws             function   pick an AWS profile and export AWS_PROFILE" \
  "fkc              function   switch the kubectl context" \
  "fssh             function   connect to a host from ~/.ssh/config" \
  "fport            function   list listening TCP ports" \
  "fsys [action]    function   systemd service: status, logs, restart, ..." \
  "fjl [priority]   function   search the journal of this boot" \
  "fenv             function   look up an environment variable" \
  "fman [query]     function   open a man page" \
  "fdl              function   follow the logs of a container" \
  "fdx              function   open a shell in a container" \
  "fds              function   stop containers" \
  | fzf --no-sort --header "fzf aliases and functions" | awk "{print \$1}"'

# ---- functions ----
# fe [query]: open the chosen file in $EDITOR
fe() { local f; f=$(fzf --query "$1" --select-1 --exit-0) && [ -n "$f" ] && ${EDITOR:-vim} "$f"; }

# fcd [dir]: cd into a subdirectory
fcd() { local d; d=$(command find "${1:-.}" -type d -not -path '*/.git/*' 2>/dev/null | fzf) && [ -n "$d" ] && cd "$d"; }

# fgb: check out a branch (local or remote)
fgb() {
  local b
  b=$(git branch --all | grep -v HEAD | sed 's#^[* ]*##; s#^remotes/[^/]*/##' | sort -u | fzf) && [ -n "$b" ] && git checkout "$b"
}

# fga: stage files picked from the modified and untracked ones (TAB for several)
fga() {
  local sel f files=()
  sel=$(git ls-files --modified --others --exclude-standard | sort -u | fzf -m) || return
  while IFS= read -r f; do [ -n "$f" ] && files+=("$f"); done <<< "$sel"
  [ "${#files[@]}" -gt 0 ] && git add -- "${files[@]}" && git status --short
}

# fgc [message]: stage ALL changes (modified, deleted, new and untracked) and commit them, after a yes/no check
fgc() {
  local msg="$*" answer
  git rev-parse --is-inside-work-tree >/dev/null 2>&1 || { echo "not in a git repo" >&2; return 1; }
  [ -n "$(git status --porcelain)" ] || { echo "nothing to commit"; return 0; }
  git status --short
  if [ -z "$msg" ]; then printf 'Commit message: '; IFS= read -r msg; fi
  [ -n "$msg" ] || { echo "empty message, nothing done" >&2; return 1; }
  answer=$(printf 'yes\nno\n' | fzf --height 20% --header "Stage ALL changes above and commit \"$msg\"?")
  [ "$answer" = yes ] && git add -A && git commit -m "$msg"
}

# fgs: pick a stash and show it (use "git stash apply <name>" to restore)
fgs() {
  local s
  s=$(git stash list | fzf --preview 'git stash show -p --color=always $(echo {} | cut -d: -f1)' | cut -d: -f1) \
    && [ -n "$s" ] && git stash show -p --color=always "$s"
}

# faws: pick an AWS CLI profile and export it for this shell
faws() {
  local p
  p=$(aws configure list-profiles | fzf --header 'AWS_PROFILE') && [ -n "$p" ] && export AWS_PROFILE="$p" && echo "AWS_PROFILE=$p"
}

# fkc: switch the current kubectl context (this edits your kubeconfig for every terminal)
fkc() { local c; c=$(kubectl config get-contexts -o name | fzf --header 'kubectl context') && [ -n "$c" ] && kubectl config use-context "$c"; }

# fssh: pick a host from ~/.ssh/config and connect
fssh() {
  local h
  h=$(awk 'tolower($1)=="host" { for (i=2; i<=NF; i++) if ($i !~ /[*?!]/) print $i }' ~/.ssh/config 2>/dev/null | sort -u | fzf --header 'ssh host') \
    && [ -n "$h" ] && ssh "$h"
}

# fport: list listening TCP ports and print the chosen line (PID is column 2)
fport() { lsof -nP -iTCP -sTCP:LISTEN 2>/dev/null | sed 1d | fzf --header 'COMMAND PID ... NAME'; }

# fsys [action]: pick a systemd service; status by default, "logs" follows its journal,
# any other systemctl action (start, stop, restart, enable, disable, ...) runs with sudo
fsys() {
  local act=${1:-status} u
  u=$( { systemctl list-units --type=service --all --no-legend --plain | awk '$2 != "not-found" {print $1}'
         systemctl list-unit-files --type=service --no-legend | awk '{print $1}'; } \
       | grep -v '@\.service$' | sort -u \
       | fzf --header "systemctl $act" --preview 'SYSTEMD_COLORS=1 systemctl status --no-pager {}') || return
  [ -n "$u" ] || return
  case $act in
    status) systemctl status --no-pager "$u" ;;
    logs)   journalctl -u "$u" -f -n 100 ;;
    *)      if [ "$(id -u)" -eq 0 ]; then systemctl "$act" "$u"; else sudo systemctl "$act" "$u"; fi ;;
  esac
}

# fjl [priority]: search this boot's journal at <priority> or worse (default warning), newest first
fjl() { journalctl -b -p "${1:-warning}" -o short-iso --no-pager | fzf -m --tac --no-sort --header "journal, ${1:-warning} and worse"; }

# fenv: pick an exported environment variable and print its value
fenv() {
  local v
  v=$(env | sed -n 's/^\([A-Za-z_][A-Za-z0-9_]*\)=.*/\1/p' | sort -u | fzf --preview 'printenv {}') && [ -n "$v" ] && printenv "$v"
}

# fman [query]: pick a man page from "man -k" with a preview, then open it
fman() {
  local sel name sec
  sel=$(man -k . 2>/dev/null | fzf --query "$1" \
          --preview 'man "$(echo {} | sed -E "s/^[^(]*\(([^)]*)\).*/\1/")" "$(echo {} | sed -E "s/^ *([^ ,(]+).*/\1/")" 2>/dev/null') || return
  [ -n "$sel" ] || return
  name=$(echo "$sel" | sed -E 's/^ *([^ ,(]+).*/\1/')
  sec=$(echo "$sel" | sed -E 's/^[^(]*\(([^)]*)\).*/\1/')
  man "$sec" "$name"
}

# _fdc: pick running containers and print their names (helper for fdl, fdx, fds)
_fdc() { docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}' | fzf "$@" | cut -f1; }

# fdl: follow the logs of a container
fdl() { local c; c=$(_fdc) && [ -n "$c" ] && docker logs -f --tail 100 "$c"; }

# fdx: open a shell in a container, bash if it exists, else sh
fdx() { local c; c=$(_fdc) && [ -n "$c" ] && docker exec -it "$c" sh -c 'command -v bash >/dev/null && exec bash || exec sh'; }

# fds: stop containers (TAB for several)
fds() { local sel c cs=(); sel=$(_fdc -m) || return; while IFS= read -r c; do [ -n "$c" ] && cs+=("$c"); done <<< "$sel"; [ "${#cs[@]}" -gt 0 ] && docker stop "${cs[@]}"; }