# zoxide
> A smarter cd command that learns your habits

## 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.)

## When to Use
- Navigating frequently visited directories quickly
- Jumping to deeply nested paths with partial names
- Replacing cd with a smarter alternative

## When NOT to Use
- Need to navigate to a directory you have never visited before
- 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

## Installation
- **homebrew**: `brew install zoxide`
- **apt**: `sudo apt install zoxide`
- **pacman**: `sudo pacman -S zoxide`
- **cargo**: `cargo install zoxide --locked`

## Related Tools
- [fzf](/tools/fzf) (complementary): fzf powers zoxide's interactive mode (zi)

---
Source: https://littlescripts.sh/tools/zoxide
