zoxide
CLI>=0.9A smarter cd command that learns your most used directories.
Frecency-based directory jumper — smarter than cd
Recipes
Curated from documentation and usage. Percentages are estimates, not measurements.
Print the best-matching directory for a keyword
zoxide query projectnameCommon failures (2)
- zoxide: no match foundthe database is empty on a fresh machine; seed it with zoxide add /path/to/dir, or pass a path you have visited
- z: command not foundz/zi are shell functions created by zoxide init, not binaries. Non-interactive callers use zoxide query instead
Run a command in a frequently used directory
cd "$(zoxide query projectname)" && pwdCommon failures (2)
- zoxide: no match foundthe database is empty on a fresh machine; seed it with zoxide add /path/to/dir, or pass a path you have visited
- z: command not foundz/zi are shell functions created by zoxide init, not binaries. Non-interactive callers use zoxide query instead
Interactive directory selection
ziInstall
Homebrew
brew install zoxideCargo
cargo install zoxideAgent notes
- When to use
- Quickly navigating to frequently visited directories
- Quick examples
zoxide query projzi # interactive picker, needs a terminal
Use from an agent
curl -s https://clihub.com/api/tools/zoxide | jq '.agentHints.provenRecipes[] | {task, command, verified}'Or call get_tool with slug zoxide on the MCP server at https://clihub.com/mcp.