The plugin calls zoxide init for Zsh.

zoxide is a smarter cd command, inspired by z and autojump.

All environment variables: ajeetdsouza/zoxide#environment-variables

Before setting the environment variables, you must declare the associative array:

typeset -A ZEC

Set the following environment variables to change the default behavior:

Eval-cache files are stored in ${Plugins[ZSH_ZOXIDE]}/._zoxide/* directory.

• Official install (recommended)
• With Zi:

zi ice as'null' from"gh-r" sbin
zi light ajeetdsouza/zoxide

Wiki: install fzf command-line fuzzy finder as Zi package.

Note:

• the alternative for zsh-zoxide is 🌀 eval annex.
• To forcefully set z function include atinit'z(){ __zoxide_z "$@"; }' when installing with Zi (#37).

zi ice has'zoxide'
zi light z-shell/zsh-zoxide

zi has'zoxide' light-mode for \
  z-shell/zsh-zoxide

zi has'zoxide' wait lucid for \
  z-shell/zsh-zoxide

Wiki: automatic, condition based (loading/unloading)

After loading the plugin – shows profiling results and then unloads zsh/zprof

zi ice has'zoxide' atinit'zmodload zsh/zprof' \
  atload'zprof | head -n 20; zmodload -u zsh/zprof'
zi light z-shell/zsh-zoxide

The plugin will call zoxide init with prefixed commands x, xi:

• Completions auto-loaded: commands, ice-modifiers
• Manpage auto installed: $ZI[MAN_DIR]
• Database directory set: $ZPFX/share, customizing-paths

x foo              # cd into highest ranked directory matching foo
x foo bar          # cd into highest ranked directory matching foo and bar
x foo /            # cd into a subdirectory starting with foo

x ~/foo            # x also works like a regular cd command
x foo/             # cd into relative path
x ..               # cd one level up
x -                # cd into the previous directory

xi foo             # cd with interactive selection (using fzf)

x foo<SPACE><TAB>  # show interactive completions

The plugin will call zoxide init with prefixed commands z, and zi.