zoxide

CLI>=0.9

A smarter cd command that learns your most used directories.

Frecency-based directory jumper — smarter than cd

3 curated recipes · not yet executed by the harness#cd#navigation#smart#rust

Recipes

Curated from documentation and usage. Percentages are estimates, not measurements.

Print the best-matching directory for a keyword

~95% est.
zoxide query projectname
Common 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

~93% est.
cd "$(zoxide query projectname)" && pwd
Common 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

~97% est.
zi

Install

Homebrewbrew install zoxide
Cargocargo install zoxide

Agent notes

When to use
Quickly navigating to frequently visited directories
Quick examples
  • zoxide query proj
  • zi # 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.

Homepage ↗MIT0 views