Your Terminal Has No Idea Where You Keep Anything
Every session starts the same way: cd into a path five folders deep, tab-completing through directories you have visited a thousand times. The shell has no memory of any of it.
zoxide gives it one. It quietly learns which directories you actually use and ranks them by frecency — frequency plus recency — so you type a few letters instead of a path.
Jump, Don't Navigate
cd ~/dev/proj/client/app/src becomes z src. When several directories match, zi opens an interactive picker instead of guessing for you. The ranking improves as you work, so the folders you live in surface first without any configuration.
Install in Two Steps
Grab the binary from your package manager — brew install zoxide, apt install zoxide, or cargo install zoxide --locked — then add one init line to your shell config, like eval "$(zoxide init zsh)". That's the whole setup.
It runs on bash, zsh, fish, PowerShell and nushell, and it's free and open source.
What's in the Guide
The before-and-after commands, how frecency ranking decides what you get, the interactive picker, the install line for each package manager and shell, and a direct link to the repo.
The full field guide is in the PDF.
Get the Guide
Drop your email below and we'll send it straight to your inbox.