← Back to tools
View AGENTS.md for zoxide
zoxide
A smarter cd command that learns your habits
Description
zoxide is a blazing-fast replacement for cd that tracks your most frequently and recently visited directories. It uses a ranking algorithm to jump to the best match for partial directory names.
Install
homebrew
brew install zoxideapt
sudo apt install zoxidepacman
sudo pacman -S zoxidecargo
cargo install zoxide --lockedAI Summary
A smarter cd command. Tracks directory visit frequency and recency, then uses a ranking algorithm to jump to the best match when given a partial name.
Capabilities
- + Learns and ranks directories by frequency and recency
- + Fuzzy matching for partial directory names
- + Interactive selection with fzf integration
- + Works with all major shells (bash, zsh, fish, etc.)
Use When
- → Navigating frequently visited directories quickly
- → Jumping to deeply nested paths with partial names
- → Replacing cd with a smarter alternative
Avoid When
- x Need to navigate to a directory you have never visited before
- x Scripting where deterministic paths are required
Usage Patterns
Jump to best matching directory
z project Jumps to the highest-ranked directory matching 'project'
Interactive directory selection
zi Opens fzf-based interactive picker for directory selection