Aloxaf/fzf-tab is tracked by TopGit as an open-source project, with 5.0k stars on GitHub, written primarily in Shell. Replace zsh's default completion selection menu with fzf!
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Ctrl+Space: select multiple results, can be configured by fzf-bindings tag
F1/F2: switch between groups, can be configured by switch-group tag
/: trigger continuous completion (useful when completing a deep path), can be configured by continuous-trigger tag
Available commands:
disable-fzf-tab: disable fzf-tab and fallback to compsys
enable-fzf-tab: enable fzf-tab
toggle-fzf-tab: toggle the state of fzf-tab. This is also a zle widget.
Configure
A common configuration is:
# disable sort when completing `git checkout`
zstyle ':completion:*:git-checkout:*' sort false
# set descriptions format to enable group support
# NOTE: don't use escape sequences (like '%F{red}%d%f') here, fzf-tab will ignore them
zstyle ':completion:*:descriptions' format '[%d]'
# set list-colors to enable filename colorizing
zstyle ':completion:*' list-colors ${(s.:.)LS_COLORS}
# force zsh not to show completion menu, which allows fzf-tab to capture the unambiguous prefix
zstyle ':completion:*' menu no
# preview directory's content with eza when completing cd
zstyle ':fzf-tab:complete:cd:*' fzf-preview 'eza -1 --color=always $realpath'
# custom fzf flags
# NOTE: fzf-tab does not follow FZF_DEFAULT_OPTS by default
zstyle ':fzf-tab:*' fzf-flags --color=fg:1,fg+:2 --bind=tab:accept
# To make fzf-tab follow FZF_DEFAULT_OPTS.
# NOTE: This may lead to unexpected behavior since some flags break this plugin. See Aloxaf/fzf-tab#455.
zstyle ':fzf-tab:*' use-fzf-default-opts yes
# switch group using `<` and `>`
zstyle ':fzf-tab:*' switch-group '<' '>'
Tmux
If you're using tmux >= 3.2, we provide a script ftb-tmux-popup to make full use of it's "popup" feature.
zstyle ':fzf-tab:*' fzf-command ftb-tmux-popup
BTW, you can also use this script outside the fzf-tab.
ls | ftb-tmux-popup
For more information, please see Wiki#Configuration.
Binary module
By default, fzf-tab uses zsh-ls-colors to parse and apply ZLS_COLORS if you have set the list-colors tag.
However, it is a pure zsh script and is slow if you have too many files to colorize.
fzf-tab is shipped with a binary module to speed up this process. You can build it with build-fzf-tab-module, then it will be enabled automatically.
Difference from other plugins
fzf-tab doesn't do "complete", it just shows you the results of the default completion system.
So it works EVERYWHERE (variables, function names, directory stack, in-word completion, etc.).
And most of your configuration for default completion system is still valid.
Compatibility with other plugins
Some plugins may also bind "^I" to their custom widget, like fzf/shell/completion.zsh or ohmyzsh/lib/completion.zsh.
By default, fzf-tab will call the widget previously bound to "^I" to get the completion list. So there is no problem in most cases, unless fzf-tab is initialized before a plugin which doesn't handle the previous binding properly.
So if you find your fzf-tab doesn't work properly, please make sure it is the last plugin to bind "^I" (If you don't know what I mean, just put it to the end of your plugin list).
Related projects
https://github.com/lincheney/fzf-tab-completion (fzf tab completion for zsh, bash and GNU readline apps)
No homepage URL was recorded for Aloxaf/fzf-tab in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How many stars does Aloxaf/fzf-tab have?
Aloxaf/fzf-tab has 5.0k GitHub stars — refresh the page for the live number, or check github.com/Aloxaf/fzf-tab. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is Aloxaf/fzf-tab open source?
Yes — Aloxaf/fzf-tab ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/Aloxaf/fzf-tab.
What is Aloxaf/fzf-tab?
Aloxaf/fzf-tab (Aloxaf/fzf-tab) is a Shell project on GitHub. From the project's own README: Replace zsh's default completion selection menu with fzf!
Where do I read more about Aloxaf/fzf-tab?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/Aloxaf/fzf-tab is the definitive source.
Read full README in the tab above.
Curious whether fzf-tab is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about fzf-tab.
/fzf-tab
