Setup

Git repository: https://github.com/ajeetdsouza/zoxide

Installation

Zoxide requires fzf. I also include fd-find, this is optionnal but it can help for first indexing instead of using find that is less intuitive. If you prefer find or other methods to list folders, that can work too !

If you get errors in zoxide edit, you need to install a recent version of FZF.

Fedora

sudo dnf install zoxide fzf fd-find

On MacOS

brew install zoxide fzf fd

On Windows

winget install ajeetdsouza.zoxide
winget install sharkdp.fd
winget install fzf
# but xargs doesn't exist...

Those commands come from the installation section, look there if you need to know more.

Or if you have cargo (and you want the latest version in case other options ship older versions)

cargo install zoxide --locked

If you have cargo-binstall

cargo binstall zoxide

Post installation steps

  1. The zoxide command should work but the z and zi commands will not be usable at this point, you need to let zoxide generate these 2 functions with code specifics to your shell. With Fish you need to add zoxide init fish | source in your configuration. Otherwise, follow the Setup zoxide on your shell in installation section.
  2. At this point, running zoxide and z should work, fzf --version too.
  3. Running fd or fdfind should also work. You can alias fd to fdfind if necessary.