fz
A shell plugin that adds fuzzy search to tab completion for the z directory jumper, enabling quick navigation through historical directories.
What is fz?
fz is a shell plugin that enhances the popular `z` directory jumper by integrating fuzzy search into its tab completion. It allows users to quickly navigate through their most frequently used directories without requiring additional key bindings, making directory switching more efficient and intuitive.
Developers and system administrators who use Bash or zsh shells and frequently navigate between directories in the terminal, especially those already using the `z` command for directory jumping.
It combines the frequency-based directory jumping of `z` with the intuitive fuzzy search interface of fzf, requiring no additional key bindings and offering seamless integration with existing workflows.
Overview
Cli shell plugin, the missing fuzzy tab completion feature for the z jump around command.
Use Cases
Best For
- Enhancing directory navigation in Bash or zsh with fuzzy search tab completion for the `z` command.
- Quickly jumping to frequently used directories without memorizing exact paths or using extra key bindings.
- Limiting directory search to subdirectories of the current working directory using the `zz` command.
- Customizing shell directory completion behavior with options for case sensitivity and home directory abbreviation.
- Integrating fuzzy search into existing `z` installations without disrupting current shell configurations.
- Improving terminal productivity for developers who manage projects across multiple directories.
Not Ideal For
- Users who don't already use the `z` command or prefer alternative directory jumpers like autojump
- Shell environments other than Bash or zsh, such as fish or Windows terminals
- Systems where installing fzf as a dependency is not feasible or adds unwanted complexity
- Developers who need GUI-based directory navigation or have minimal terminal usage
Pros & Cons
Pros
Enhances `z`'s tab completion with fzf's fuzzy search, allowing intuitive directory matching without exact paths, as shown in the demo gif.
Works with existing `z` commands without requiring additional key bindings, maintaining user workflow familiarity as emphasized in the README.
Compatible with both Bash and zsh, covering two popular shells with dedicated installation instructions for each.
The `zz` command restricts searches to current directory subdirectories, useful for focused navigation within projects.
Offers configurable options like case sensitivity and home directory abbreviation via environment variables, allowing personalized setup.
Cons
Requires fzf to be installed separately, adding setup steps and potential compatibility issues, which the README acknowledges as a prerequisite.
Only supports Bash and zsh, excluding users of other shells like fish or tcsh, reducing its universality.
Installation involves multiple manual steps, such as sourcing scripts and managing dependencies, which can be error-prone compared to plug-and-play tools.
Frequently Asked Questions
Related Projects
zoxideA smarter cd command. Supports all major shells.
autojumpA cd command that learns - easily navigate directories from the command line
PathPickerPathPicker accepts a wide range of input -- output from git commands, grep results, searches -- pretty much anything. After parsing the input, PathPicker presents you with a nice UI to select which files you're interested in. After that you can open them in your favorite editor or execute arbitrary commands.
z.lua:zap: A new cd command that helps you navigate faster by learning your habits.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.