fzf

 # Single expression: drop the first field
echo foo bar baz | fzf --with-nth 2..

# Use template to rearrange fields
echo foo,bar,baz | fzf --delimiter , --with-nth '{n},{1},{3},{2},{1..2}'

 # Single expression
echo foo bar baz | fzf --accept-nth 2

# Template
echo foo bar baz | fzf --accept-nth 'Index: {n}, 1st: {1}, 2nd: {2}, 3rd: {3}'

       

 # Interactive filtering of a log stream
tail -f *.log | fzf --tail 100000 --tac --no-sort --exact

• length shorter length
• chunk shorter matched chunk (delimited by whitespaces)
• pathname matched substring in the file name of the path
• begin matched substring closer to the beginning
• end matched substring closer to the end
• index appeared earlier in the input stream

# Avoid rendering both fzf instances at the same time
fzf --multi | fzf --sync

# fzf will not render intermediate states
(sleep 1; seq 1000000; sleep 1) |
fzf --sync --query 5 --listen --bind start:up,load:up,result:up,focus:change-header:Ready

BASE SCHEME:

 -1         Default terminal foreground/background color
                             (or the original color of the text)
 0 ~ 15     16 base colors,
 black, red, green, yellow, blue, magenta, cyan, white,
 bright-black (gray | grey)
 bright-red, bright-green, bright-yellow, bright-blue, 
 bright-magenta, bright-cyan, bright-white,
 16 ~ 255   ANSI 256 colors
 #rrggbb    24-bit colors

# Seoul256 theme with 8-bit colors
# (https://github.com/junegunn/seoul256.vim)
fzf --color='bg:237,bg+:236,info:143,border:240,spinner:108' \
    --color='hl:65,fg:252,header:65,fg+:252' \
    --color='pointer:161,marker:168,prompt:110,hl+:108'

# Seoul256 theme with 24-bit colors
fzf --color='bg:#4B4B4B,bg+:#3F3F3F,info:#BDBB72,border:#6B6B6B, \
    --color='spinner:#98BC99' \
    --color='hl:#719872,fg:#D9D9D9,header:#719872,fg+:#D9D9D9' \
    --color='pointer:#E12672,marker:#E17899,prompt:#98BEDE,hl+:#98BC99'

# Seoul256 light theme with 24-bit colors, each entry separated by whitespaces
fzf --style full --color= fg:#616161 fg+:#616161
                     bg:#ffffff bg+:#e9e9e9 alt-bg:#f1f1f1
                     hl:#719872 hl+:#719899
                     pointer:#e12672 marker:#e17899
                     header:#719872
                     spinner:#719899 info:#727100
                     prompt:#0099bd query:#616161
                     border:#e1e1e1 '

If a negative value is specified, the height is calculated as the terminal height minus the given value. When prefixed with ~, fzf will automatically determine the height in the range according to the input size. You can combine ~ with a negative value.

# Will not take up 100% of the screen
seq 5 | fzf --height=~100%

# Adapt to input size, up to terminal height minus 1
seq 5 | fzf --height=~-1

On tmux 3.7 or above and on Zellij, the floating pane is not modal; you can switch to other panes and windows while fzf is running, and move and resize the pane with the mouse. The native border of the pane is the handle for moving and resizing it, so it is used by default and border-native is implied. --border-label is displayed on the native border, and change-border-label and transform-border-label update it (--border-label-pos is ignored). On tmux, fzf holds the label in the @fzf-border-label option of the pane and sets its pane-border-format to read it back, so the label is displayed if pane-border-status is enabled in tmux. The title of the pane is left alone. On Zellij, the label is the name of the pane.

fzf draws its own border instead when a border style is explicitly specified with --border, so that it is the only border shown. none and line are treated as no border. Give border-native to keep the native border nonetheless. On tmux, the fzf-drawn border is shown in a modal popup, since the native border of a tmux floating pane cannot be removed; this is also the case on tmux versions below 3.7. Example:

 # Popup in the center with 70% width and height
fzf --popup 70%

# Popup on the left with 40% width and 100% height
fzf --popup right,40%

# Popup on the bottom with 100% width and 30% height
fzf --popup bottom,30%

# Popup on the top with 80% width and 40% height
fzf --popup top,80%,40%

# Popup with a native tmux or Zellij border in the center with 80% width and height
fzf --popup center,80%,border-native

    default       Display from the bottom of the screen
    reverse       Display from the top of the screen
    reverse-list  Display from the top of the screen, prompt at the bottom

Each part can be given in absolute number or in percentage relative to the terminal size with % suffix. Example:

fzf --margin 10%
fzf --margin 1,5%

 fzf --margin 5% --padding 5% --border --preview 'cat {}' \
  --color bg:#222222,preview-bg:#333333

 # ANSI color codes are supported
# (with https://github.com/busyloop/lolcat)
label=$(curl -s http://metaphorpsum.com/sentences/1 | lolcat -f)

# Border label at the center
fzf --height=10 --border --border-label="QQQ $label QQQ" --color=label:italic:black

# Left-aligned (positive integer)
fzf --height=10 --border --border-label="QQQ $label QQQ" --border-label-pos=3
--color=label:italic:black

# Right-aligned (negative integer) on the bottom line (:bottom)
fzf --height=10 --border --border-label="QQQ $label QQQ" --border-label-pos=-3:bottom
--color=label:italic:black 

When --id-nth is also set, fzf enables field-based tracking across reloads. See --id-nth for details.

Without --id-nth, --track uses index-based tracking that does not persist across reloads. Example:

# Index-based tracking (does not persist across reloads)
git log --oneline --graph --color=always | nl |
   fzf --ansi --track --no-sort --layout=reverse-list

# Track by first field (Example: pod name) across reloads
kubectl get pods | fzf --track --id-nth 1 --header-lines=1 \
   --bind 'ctrl-r:reload:kubectl get pods'

With --track fzf extracts the tracking key from the current item using the nth expression and searches for a matching item in the reloaded list. While searching, the UI is blocked (query input and cursor movement are disabled, and the prompt is dimmed). With reload, the blocked state clears as soon as the match is found in the stream. With reload-sync, the blocked state persists until the entire stream is complete. Press Escape or Ctrl-C to cancel the blocked state without quitting fzf.

The info line shows +T* (or +t* for one-off tracking) while the search is in progress. With --multi, selected items are preserved across reload-sync by matching their identity fields in the reloaded list.

Example:

 # Track and preserve selections by pod name across reloads
kubectl get pods | fzf --multi --track --id-nth 1 --header-lines=1 \
 --bind 'ctrl-r:reload-sync:kubectl get pods'

 history | fzf --tac --no-sort

 default              On the left end of the horizontal separator
right                On the right end of the horizontal separator
hidden               Do not display finder info
inline               After the prompt with the default prefix ' < '
inline:PREFIX        After the prompt with a non-default prefix
inline-right         On the right end of the prompt line
inline-right:PREFIX  On the right end of the prompt line with a custom prefix

 # Prepend the current cursor position in yellow
fzf --info-command='printf "\x1b[33;1m$FZF_POS\x1b[m/$FZF_INFO QQQ"'

Unless explicitly specified, the separator is not displayed if the input section is already visually separated from the list section by a border line (Example: --input-border or --header-border).
ANSI color codes are supported.

fzf --preview='head -$LINES {}'
ls -l | fzf --preview="echo user={3} when={-4..-2}; cat {-1}" --header-lines=1

fzf also exports $FZF_PREVIEW_TOP and $FZF_PREVIEW_LEFT so that the preview command can determine the position of the preview window.

A placeholder expression starting with + flag will be replaced to the space-separated list of the selected items (or the current item if no selection was made) individually quoted. Example:

 fzf --multi --preview='head -10 {+}'
git log --oneline | fzf --multi --preview 'git show {+1}'

Each expression expands to a quoted string, so that it's safe to pass it as an argument to an external command. So you should not manually add quotes around the curly braces. But if you don't want this behavior, you can put r flag (raw) in the expression (Example: {r}, {r1}, etc). Use it with caution as unquoted output can lead to broken commands.

When using a field index expression, leading and trailing whitespace is stripped from the replacement string. To preserve the whitespace, use the s flag.

A placeholder expression with f flag is replaced to the path of a temporary file that holds the evaluated list. This is useful when you pass a large number of items and the length of the evaluated string may exceed ARG_MAX. Example:

# See the sum of all the matched numbers
# This won't work properly without 'f' flag due to ARG_MAX limit.
seq 100000 | fzf --preview "awk '{sum+=\$1} END {print sum}' {*f}"

# Use {+f} to get the selected items as a line-separated list
seq 100 | fzf --multi --bind 'enter:become:cat {+f}'

* {q} is replaced to the current query string
* {q} can contain field index expressions. Example: {q:1}, {q:2..}, etc.
* {n} is replaced to the zero-based ordinal index of the current item.
Use {+n} if you want all index numbers when multiple lines are selected.

Preview window will be updated even when there is no match for the current query if any of the placeholder expressions evaluates to a non-empty string or {q} is in the command template. fzf can render partial preview content before the preview command completes. ANSI escape sequence for clearing the display (CSI 2 J) is supported, so you can use it to implement preview window that is constantly updating. Example:

 fzf --preview 'for i in $(seq 100000); do
(( i % 200 == 0 )) && printf "\033[2J"
echo "$i"
sleep 0.01
done'

   fzf --preview='fzf-preview.sh {}'

* border-rounded (default on non-Windows platforms)
* border-sharp (default on Windows)
* border-bold
* border-double
* border-dashed
* border-block
* border-thinblock
* border-horizontal
* border-top
* border-bottom

• next places the preview window adjacent to the input section, on the list side: above the input in the default layout, below the input in --layout=reverse.
• If the argument contains :hidden, the preview window will be hidden by default until toggle-preview action is triggered.
• If size is given as 0, preview window will not be visible, but fzf will still execute the command in the background.
• Long lines are truncated by default. Line wrap can be enabled with wrap flag. wrap-word flag enables word-level wrapping, which breaks lines at word boundaries instead of mid-word.
• Preview window will automatically scroll to the bottom when follow flag is set, similarly to howA tail -f works.

 fzf --preview-window follow --preview 'for i in $(seq 100000); do
   echo "$i"
   sleep 0.01
   (( i % 300 == 0 )) && printf "\033[2J"
   done'

• Cyclic scrolling is enabled with cycle flag.
• To hide the scroll offset information on the top right corner, specify noinfo.
• To change the style of the border of the preview window, specify one of the options for --border with border- prefix. Example: border-rounded (border with rounded edges, default), border-sharp (border with sharp edges), border-left, border-none, etc.
• In addition to the other border styles, border-line style is also supported, which draws a single separator line between the preview window and the rest of the interface.
• [:+SCROLL[OFFSETS][/DENOM]] determines the initial scroll offset of the preview window. - SCROLL can be either a numeric integer or a single-field index expression that refers to a numeric integer or {n} to refer to the zero-based ordinal index of the current item. - The optional OFFSETS part is for adjusting the base offset. It should be given as a series of signed integers (-INTEGER or +INTEGER). - The final /DENOM part is for specifying a fraction of the preview window height.
• ~HEADER_LINES keeps the top N lines as the fixed header so that they are always visible.
• default resets all options previously set to the default.

 # Non-default scroll window positions and sizes
fzf --preview="head {}" --preview-window=up,30%
fzf --preview="file {}" --preview-window=down,1

# Initial scroll offset is set to the line number of each line of
# git grep output *minus* 5 lines (-5)
git grep --line-number '' |
fzf --delimiter : --preview 'nl {1}' --preview-window '+{2}-5'

# Preview with bat, matching line in the middle of the window below
# the fixed header of the top 3 lines
#
#   ~3    Top 3 lines as the fixed header
#   +{2}  Base scroll offset extracted from the second field
#   +3    Extra offset to compensate for the 3-line header
#   /2    Put in the middle of the preview area
#
git grep --line-number '' |
   fzf --delimiter : \
     --preview 'bat --style=full --color=always --highlight-line {2} {1}' \
     --preview-window '~3,+{2}+3/2'

# Display top 3 lines as the fixed header
   fzf --preview 'bat --style=full --color=always {}' --preview-window '~3'

fzf --preview 'cat {}' --preview-window \
'right,border-left,<30(up,30%,border-bottom)'

SCRIPTING

fzf --expect=ctrl-v,ctrl-t,alt-s --expect=f1,f2,~,@

fzf --multi \
--bind 'enter:print()+accept,ctrl-y:select-all+print(ctrl-y)+accept'

 foo=$(seq 100 | fzf --no-clear) || (
# Need to manually switch back to the main screen when cancelled
tput rmcup
exit 1
) && seq "$foo" 100 | fzf

 KEY/EVENT BINDING

• If the port number is omitted or 0, fzf will choose a port and export it as $FZF_PORT to the child processes.
• If a Unix socket path is given, fzf will create a Unix domain socket at the given path. The existing file will be removed. The path to the socket file is exported as $FZF_SOCK .
• If $FZF_API_KEY is set, the server would require sending an API key with the same value in the x-api-key HTTP header.
• $FZF_API_KEY is required for a non-localhost listen address.
• To allow remote process execution, use --listen-unsafe.

 # Start HTTP server on port 6266
fzf --listen 6266

# Send action to the server
curl -XPOST localhost:6266 -d 'reload(seq 100)+change-prompt(hundred> )'

# Start HTTP server on port 6266 with remote connections allowed
# * Listening on non-localhost address requires using an API key
export FZF_API_KEY="$(head -c 32 /dev/urandom | base64)"
fzf --listen 0.0.0.0:6266

# Send an authenticated action
curl -XPOST localhost:6266 -H "x-api-key: $FZF_API_KEY" -d 'change-query(yo)'

# Choose port automatically and export it as $FZF_PORT to the child process
fzf --listen --bind 'start:execute-silent:echo $FZF_PORT > /tmp/fzf-port'

# Get program state in JSON format (experimental)
# - GET Parameters:
#    - limit: number of items to return (default: 100)
#    - offset: number of items to skip (default: 0)
curl localhost:6266

# Automatically select items with .txt extension
fzf --multi --sync --listen --bind 'load:transform:
  pos=1
  curl -s localhost:$FZF_PORT?limit=1000 | jq -r .matches[].text | while read -r text; do
  if [[ $text =~ \.txt$ ]]; then
   echo -n "+pos($pos)+select"
   fi
     pos=$((pos + 1))
      done
      echo +first
        '

 fzf --listen=/tmp/fzf.sock

# GET
curl --unix-socket /tmp/fzf.sock http

# POST
curl --unix-socket /tmp/fzf.sock http -d up 

cat /usr/share/dict/words | fzf --filter abc --bench 10s

* file: Include files in the search result
* dir: Include directories in the search result
* hidden: Include and follow hidden directories
* follow: Follow symbolic links

eval "$(fzf --bash)"

l source <(fzf --zsh)

 fzf --fish | source

 fzf --nushell | save -f ~/.config/nushell/autoload/_fzf_integration.nu

 # Click on the header line to limit search scope
ps -ef | fzf --style full --layout reverse --header-lines 1 \
   --header-lines-border bottom --no-list-border \
   --color fg:dim,nth:regular \
   --bind 'click-header:transform-nth(
        echo $FZF_CLICK_HEADER_NTH
        )+transform-prompt(
        echo "$FZF_CLICK_HEADER_WORD> "
        )'

 # Live process list, refreshed every 2 seconds.
# --track --id-nth 2 keeps the cursor on the same PID across reloads.
fzf --header-lines 1 --track --id-nth 2 \
  --bind 'start,every(2):reload-sync:ps -ef'

# Auto-accept after 10 seconds of inactivity, with a countdown in the footer after 5s.
fzf --bind 'every(1):bg-transform:
  if   [[ $FZF_IDLE_TIME -lt 5  ]]; then echo change-footer:
  elif [[ $FZF_IDLE_TIME -lt 10 ]]; then echo "change-footer:auto-accept in $((10 - FZF_IDLE_TIME))s"
  else echo accept
  fi'

action-name[...]
action-name{...}
action-name<...>
action-name~...~
action-name!...!
action-name@...@
action-name#...#

action-name$...$
action-name%...%
action-name^...^
action-name&...&
action-name*...*
action-name;...;
action-name/.../
action-name|...|
action-name:...