Replace zsh's default completion selection menu with a fuzzy-finding interface powered by fzf.
fzf-tab is a Zsh plugin that replaces the shell's default tab completion menu with an interactive interface powered by the fuzzy finder fzf. It allows users to visually browse, search, and select completion candidates using fuzzy matching, making command-line navigation faster and more intuitive. The plugin integrates seamlessly with Zsh's existing completion system, preserving all native configurations and behaviors.
Zsh users, particularly developers and system administrators who frequently use the command line and want a more efficient, visual completion experience. It's ideal for those already familiar with fzf and looking to enhance their shell workflow.
Developers choose fzf-tab because it provides the flexibility and power of fzf directly within Zsh completion, without breaking existing setups. Its unique selling point is that it works everywhere Zsh completion does—including variables, functions, and in-word completion—while adding multi-selection, previews, and group navigation.
Replace zsh's default completion selection menu with fzf!
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Works with all Zsh completion contexts, including variables and in-word completion, without breaking existing configurations, as emphasized in the 'Difference from other plugins' section.
Provides fuzzy search, multi-selection with Ctrl+Space, and group navigation via F1/F2, making it easy to browse and select from large completion lists interactively.
Allows setting custom previews for commands, such as using eza for directory contents, enhancing usability with visual feedback, as shown in the configuration examples.
Integrates with tmux's popup feature for a detached, floating completion window, optimizing the interface for tmux users, detailed in the tmux section.
Must be loaded after compinit but before other widgets, which can cause conflicts if not managed carefully, as warned in the install section and compatibility notes.
Relies on a pure zsh script for colorization that is slow with large file lists, requiring an optional compiled module for optimization, which adds setup overhead.
Uses zstyle commands for customization, which can be verbose and unintuitive for users not familiar with Zsh's completion system, leading to a steeper learning curve.