NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #9 by repository stars
Latest stable
v0.75.0
Last release today
19 Nov 2026
Ships fairly regularly
a new release about every 1 weeks
Nearly every release is documented
notes for 42 of 42 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
1214 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
https://github.com/user-attachments/assets/40abe7e6-8c98-4a13-85b7-17e69372ef9e
change-with-nthhttps://github.com/user-attachments/assets/40abe7e6-8c98-4a13-85b7-17e69372ef9e
change-with-nth action for dynamically changing the --with-nth option.
--with-nth to be set initially.| can be given to cycle through.echo -e "a b c\nd e f\ng h i" | fzf --with-nth .. \
--bind 'space:change-with-nth(1|2|3|1,3|2,3|)'
change-header-lines action for dynamically changing the --header-lines option=== query: 'l' ===
[all] baseline: 168.87ms current: 95.21ms (1.77x) matches: 5069891 (94.78%)
[1T] baseline: 1652.22ms current: 841.40ms (1.96x) matches: 5069891 (94.78%)
=== query: 'lin' ===
[all] baseline: 343.27ms current: 252.59ms (1.36x) matches: 3516507 (65.74%)
[1T] baseline: 3199.89ms current: 2230.64ms (1.43x) matches: 3516507 (65.74%)
=== query: 'linux' ===
[all] baseline: 85.47ms current: 63.72ms (1.34x) matches: 307229 (5.74%)
[1T] baseline: 774.64ms current: 589.32ms (1.31x) matches: 307229 (5.74%)
=== query: 'linuxlinux' ===
[all] baseline: 55.13ms current: 35.67ms (1.55x) matches: 12230 (0.23%)
[1T] baseline: 461.99ms current: 332.38ms (1.39x) matches: 12230 (0.23%)
=== query: 'linuxlinuxlinux' ===
[all] baseline: 51.77ms current: 32.53ms (1.59x) matches: 865 (0.02%)
[1T] baseline: 409.99ms current: 296.33ms (1.38x) matches: 865 (0.02%)
nth attribute merge order to respect precedence hierarchy (#4697)printf with builtin printf to bypass local indirections (#4684) (@DarrenBishop)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
https://github.com/user-attachments/assets/8d9e6e29-1bde-49d3-b580-c560da394a5d
https://github.com/user-attachments/assets/8d9e6e29-1bde-49d3-b580-c560da394a5d
--wrap=word (or --wrap-word) option and toggle-wrap-word action for word-level line wrapping in the list sectionctrl-/ and alt-/ from toggle-wrap to toggle-wrap-wordfzf --wrap=word
wrap-word flag for --preview-window to enable word-level wrappingtoggle-preview-wrap-word actionfzf --preview 'bat --style=plain --color=always {}' \
--preview-window wrap-word \
--bind space:toggle-preview-wrap-word
--color: underline-double, underline-curly, underline-dotted, underline-dashedfzf --color 'fg:underline-curly,current-fg:underline-dashed'
4:N) and underline colors (SGR 58/59)# In the list section
printf '\e[4:3;58;2;255;0;0mRed curly underline\e[0m\n' | fzf --ansi
# In the preview window
fzf --preview "printf '\e[4:3;58;2;255;0;0mRed curly underline\e[0m\n'"
--preview-wrap-sign to set a different wrap indicator for the preview windowalt-gutter color option (#4602) (@hedgieinsocks)$FZF_WRAP environment variable to child processes (char or word when wrapping is enabled) (#4672) (@bitraid)ALT-ENTER to reformat and insert selected commandsSHIFT-DELETE)_fzf_compgen_{path,dir} to respect FZF_COMPLETION_{PATH,DIR}_OPTS (#4592) (@shtse8, @LangLangBart)--preview-window follow not working correctly with wrapping (#3243, #4258)track-current unset after a combined movement action (#4649)--accept-nth being ignored in filter mode (#4636) (@charemma)maxWidth (#4596) (@LangLangBart)x-api-key header not required for GET requests (#4627)execute triggered via a server request (#4653)redraw-current-line (#4635) (@jameslazo)fzf-tmux TERM quoting and added mktemp usage (#4664) (@Goofygiraffe06)FuzzyMatchV2 (#4608)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added --freeze-left=N option to keep the leftmost N columns always visible. ```sh
<img width="852" height="761" alt="image" src="https://github.com/user-attachments/assets/7e13d33e-085d-4fb2-b2ce-ce1497dd79d9" />
--freeze-left=N option to keep the leftmost N columns always visible.# Keep the file name column fixed and always visible
git grep --line-number --color=always -- '' |
fzf --ansi --delimiter : --freeze-left 1
# Can be used with --keep-right
git grep --line-number --color=always -- '' |
fzf --ansi --delimiter : --freeze-left 1 --keep-right
--freeze-right=N option to keep the rightmost N columns always visible.# Stronger version of --keep-right that always keeps the right-end visible
fd | fzf --freeze-right 1
# Keep the base name always visible
fd | fzf --freeze-right 1 --delimiter /
# Keep both leftmost and rightmost components visible
fd | fzf --freeze-left 1 --freeze-right 1 --delimiter /
--info=inline to print the spinner (load indicator).Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixed a bug preventing 'ctrl-h' from being bound to an action
--no-color / NO_COLOR theme (#4561)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This version introduces many new features centered around the new "raw" mode.
This version introduces many new features centered around the new "raw" mode.
| Type | Class | Name | Description |
|---|---|---|---|
| New | Option | --raw |
Enable raw mode by default |
| New | Option | --gutter CHAR |
Set the gutter column character |
| New | Option | --gutter-raw CHAR |
Set the gutter column character in raw mode |
| Enhancement | Option | --listen SOCKET |
Added support for Unix domain sockets |
| New | Action | toggle-raw |
Toggle raw mode |
| New | Action | enable-raw |
Enable raw mode |
| New | Action | disable-raw |
Disable raw mode |
| New | Action | up-match |
Move up to the matching item |
| New | Action | down-match |
Move down to the matching item |
| New | Action | best |
Move to the matching item with the best score |
| New | Color Name | nomatch |
Color for non-matching items in raw mode |
| New | Color Attr | strip |
Remove original colors |
| New | Env Var | FZF_RAW |
Matching status in raw mode (0, 1, or undefined) |
| New | Env Var | FZF_DIRECTION |
up or down depending on the layout |
| New | Env Var | FZF_SOCK |
Path to the Unix domain socket fzf is listening on |
| Enhancement | Key | CTRL-N |
down -> down-match |
| Enhancement | Key | CTRL-P |
up -> up-match |
| Enhancement | Shell | CTRL-R binding |
Toggle raw mode with ALT-R |
| Enhancement | Shell | CTRL-R binding |
Opt-out with an empty FZF_CTRL_R_COMMAND |
This version introduces a new "raw" mode (named so because it shows the list "unfiltered"). In raw mode, non-matching items stay in their original positions, but appear dimmed. This allows you to see the surrounding items of a match and better understand the context of it. You can enable raw mode by default with --raw, but it's often more useful when toggled dynamically with the toggle-raw action.
tree | fzf --reverse --bind alt-r:toggle-raw
While non-matching items are displayed in a dimmed color, they are treated just like matching items, so you can place the cursor on them and perform any action. If you prefer to navigate only through matching items, use the down-match and up-match actions, which are from now on bound to CTRL-N and CTRL-P respectively, and also to ALT-DOWN and ALT-UP.
| Key | Action | With --history |
|---|---|---|
down |
down |
|
up |
up |
|
ctrl-j |
down |
|
ctrl-k |
up |
|
ctrl-n |
down-match |
next-history |
ctrl-p |
up-match |
prev-history |
alt-down |
down-match |
|
alt-up |
up-match |
[!NOTE]
CTRL-NandCTRL-Pare bound tonext-historyandprev-historywhen--historyoption is enabled, so in that case, you'll need to manually bind them, or useALT-DOWNandALT-UPinstead.
[!TIP]
up-matchanddown-matchare equivalent toupanddownwhen not in raw mode, so you can safely bind them toupandarrowkeys if you prefer.fzf --bind up:up-match,down:down-match
In raw mode, the input list is presented in its original order, unfiltered, and your cursor will not move to the matching item automatically. Here are ways to customize the behavior.
# When the result list is updated, move the cursor to the item with the best score
# (assuming sorting is not disabled)
fzf --raw --bind result:best
# Move to the first matching item in the original list
# - $FZF_RAW is set to 0 when raw mode is enabled and the current item is a non-match
# - $FZF_DIRECTION is set to either 'up' or 'down' depending on the layout direction
fzf --raw --bind 'result:first+transform:[[ $FZF_RAW = 0 ]] && echo $FZF_DIRECTION-match'
To make the mode visually distinct, the gutter column is rendered in a dashed line using ▖ character. But you can customize it with the --gutter-raw CHAR option.
# Use a thinner gutter instead of the default dashed line
fzf --bind alt-r:toggle-raw --gutter-raw ▎
Non-matching items are displayed in a dimmed color by default, but you can change it with the --color nomatch:... option.
fzf --raw --color nomatch:red
fzf --raw --color nomatch:red:dim
fzf --raw --color nomatch:red:dim:strikethrough
fzf --raw --color nomatch:red:dim:strikethrough:italic
For colored input, dimming alone may not be enough, and you may prefer to remove colors entirely. For that case, a new special style attribute strip has been added.
fd --color always | fzf --ansi --raw --color nomatch:dim:strip:strikethrough
You may want to perform different actions depending on whether the current item is a match or not. For that, fzf now exports $FZF_RAW environment variable.
It's:
1 if the current item is a match0 otherwise# Do not allow selecting non-matching items
fzf --raw --bind 'enter:transform:[[ ${FZF_RAW-1} = 1 ]] && echo accept || echo bell'
The CTRL-R binding (command history) now lets you toggle raw mode with ALT-R.
The screenshot on the right shows the updated gutter style:
This version includes a few minor updates to fzf's classic visual style:
▌).--color base16 theme (alias: 16) has been updated for better compatibility with both dark and light themes.--listen now supports Unix domain socketsIf an argument to --listen ends with .sock, fzf will listen on a Unix domain socket at the specified path.
fzf --listen /tmp/fzf.sock --no-tmux
# GET
curl --unix-socket /tmp/fzf.sock http
# POST
curl --unix-socket /tmp/fzf.sock http -d up
Note that any existing file at the given path will be removed before creating the socket, so avoid using an important file path.
--gutter CHARThe gutter column can now be customized using --gutter CHAR and styled with --color gutter:.... Examples:
# Right-aligned gutter
fzf --gutter '▐'
# Even thinner gutter
fzf --gutter '▎'
# Yellow checker pattern
fzf --gutter '▚' --color gutter:yellow
# Classic style
fzf --gutter ' ' --color gutter:reverse
--gutter-raw CHARAs noted above, the --gutter-raw CHAR option was also added for customizing the gutter column in raw mode.
The following actions were introduced to support working with raw mode:
| Action | Description |
|---|---|
toggle-raw |
Toggle raw mode |
enable-raw |
Enable raw mode |
disable-raw |
Disable raw mode |
up-match |
Move up to the matching item; identical to up if raw mode is disabled |
down-match |
Move down to the matching item; identical to down if raw mode is disabled |
best |
Move to the matching item with the best score; identical to first if raw mode is disabled |
$FZF_DIRECTION$FZF_DIRECTION is now exported to child processes, indicating the list direction of the current layout:
up for the default layoutdown for reverse or reverse-listThis simplifies writing transform actions involving layout-dependent actions like {up,down}-match, {up,down}-selected, and toggle+{up,down}.
fzf --raw --bind 'result:first+transform:[[ $FZF_RAW = 0 ]] && echo $FZF_DIRECTION-match'
$FZF_SOCKWhen fzf is listening on a Unix domain socket using --listen, the path to the socket is exported as $FZF_SOCK, analogous to $FZF_PORT for TCP sockets.
$FZF_RAWAs described above, $FZF_RAW is now exported to child processes in raw mode, indicating whether the current item is a match (1) or not (0). It is not defined when not in raw mode.
$FZF_CTRL_R_COMMANDYou can opt-out CTRL-R binding from the shell integration by setting FZF_CTRL_R_COMMAND to an empty string. Setting it to any other value is not supported and will result in a warning.
# Disable the CTRL-R binding from the shell integration
FZF_CTRL_R_COMMAND= eval "$(fzf --bash)"
--bindPull request #3996 added support for many additional keys for --bind option, such as ctrl-backspace.
In the previous versions, the recommended way to hide the gutter column was to set --color gutter:-1. That's because the gutter column was just a space character, reversed. But now that it's using a visible character (▌), applying the default color is no longer enough to hide it. Instead, you can set it to a space character.
# Hide the gutter column
fzf --gutter ' '
# Classic style
fzf --gutter ' ' --color gutter:reverse
--color optionIn the previous versions, some elements had default style attributes applied and you would have to explicitly unset them with regular attribute if you wanted to reset them. This is no longer needed now, as the default style attributes are applied only when you do not specify any color or style for that element.
# No 'dim', just red and italic.
fzf --ghost 'Type to search' --color ghost:red:italic
Starting with this release, fzf is built with Go 1.23. Support for some old OS versions has been dropped.
See https://go.dev/wiki/MinimumRequirements.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix incorrect truncation of --info-command with --info=inline-right
--info-command with --info=inline-right (#4479)CTRL-T and ALT-C to preserve the last yank (#4496)FZF_DEFAULT_* variables when using winpty (#4497) (#4400)One column per quarter.