How to install fz on Ubuntu?

For Bash, clone fzf, download z and fz scripts, and source them in ~/.bashrc. For zsh, use zplug to install both z and fz, as detailed in the README's Ubuntu section.

fz vs autojump: which is better for directory navigation?

fz enhances `z` with fuzzy search via tab completion, while autojump uses a different algorithm and commands. Choose fz if you already use `z` and want seamless fuzzy integration; autojump might be better for new users seeking a standalone tool.

Why is fz not working after installation?

Ensure `z` is installed and sourced before fz, and that fzf is properly installed. Check shell configuration files for correct sourcing order, as the README notes fz must be sourced after z.

Can fz be used with fish shell?

No, fz only supports Bash and zsh, as stated in the README. Fish users would need alternative directory navigation plugins or adaptations.

How to customize fz for case-insensitive search?

Set the environment variable `FZ_CASE_INSENSITIVE=1` (default) or `0` to disable, allowing control over case sensitivity in completion, as described in the Usage section.

fz

MPL-2.0Shell

A shell plugin that adds fuzzy search to tab completion for the z directory jumper, enabling quick navigation through historical directories.

GitHub

572 stars29 forks0 contributors

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.

Target Audience

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.

Value Proposition

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.

Related Projects

Community-curated · Updated weekly · 100% open source

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.

Submit a project Star on GitHub

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

Fuzzy Tab Completion

Enhances `z`'s tab completion with fzf's fuzzy search, allowing intuitive directory matching without exact paths, as shown in the demo gif.

Seamless Integration

Works with existing `z` commands without requiring additional key bindings, maintaining user workflow familiarity as emphasized in the README.

Multi-shell Support

Compatible with both Bash and zsh, covering two popular shells with dedicated installation instructions for each.

Subdirectory Limiting

The `zz` command restricts searches to current directory subdirectories, useful for focused navigation within projects.

Customizable Behavior

Offers configurable options like case sensitivity and home directory abbreviation via environment variables, allowing personalized setup.

Cons

Dependency on fzf

Requires fzf to be installed separately, adding setup steps and potential compatibility issues, which the README acknowledges as a prerequisite.

Limited Shell Compatibility

Only supports Bash and zsh, excluding users of other shells like fish or tcsh, reducing its universality.

Complex Installation Process

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

Command-Line Apps

zoxide

A smarter cd command. Supports all major shells.

Stars37,671

Forks834

Last commit6 days ago

autojump

A cd command that learns - easily navigate directories from the command line

Stars16,929

Forks709

Last commit1 year ago

PathPicker

PathPicker 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.

Stars5,224

Forks281

Last commit1 year ago