zoxide(1)
A smarter cd command that learns your most-used directories and lets you jump to them with minimal typing.
Synopsis
zoxide [OPTION] SUBCOMMANDDescription
zoxide is a blazing fast autojumper that tracks which directories you visit most frequently, then intelligently predicts where you want to go next. It replaces the standard cd command with a faster alternative that learns your navigation patterns.
After installation, it integrates with your shell (bash, zsh, fish, etc.) so you can jump to directories by typing z followed by a partial directory name. For example, z proj might take you to ~/code/my-project if you visit it often.
zoxide stores a database of visited directories with frecency scores (a combination of frequency and recency), allowing intelligent completion and fuzzy matching across your entire directory history.
Common options
| Flag | What it does |
|---|---|
init SHELL | Initialize zoxide for your shell (bash, zsh, fish, powershell, etc.); output hook code to add to your config |
-h, --help | Print help information |
-V, --version | Print version number |
Examples
Initialize zoxide for zsh; add this line to ~/.zshrc to enable the z command
eval "$(zoxide init zsh)"Jump to the most-visited directory matching 'myproject' (e.g., ~/work/myproject)
z myprojectJump to an exact directory path; zoxide also works like regular cd
z ~/code/projInteractive search mode; displays ranked list of matching directories and lets you select one
ziShow all tracked directories sorted by frecency score
zoxide query --listRemove a directory from the zoxide database
zoxide remove ~/old/pathMigrate directory history from autojump to zoxide
zoxide import --from autojumpJump back to the previous directory (like cd -)
z -