← Back to home

What is zoxide?

zoxide is a smarter cd command written in Rust by Ajeet D'Souza, inspired by z and autojump. It remembers which directories you use most frequently, so you can "jump" to them in just a few keystrokes. With over 28k GitHub stars, it has revolutionized directory navigation for command-line users worldwide.

😤 Traditional cd Pain Points: Tired of typing long directory paths? Fed up with `cd ../../projects/my-app/src/components`? Frustrated with remembering exact directory names? zoxide learns your habits and lets you jump anywhere with just a few characters.

            🚀 Why Latest Versions Matter: zoxide is actively developed with frequent releases containing performance improvements, new shell integrations, enhanced algorithms, and better compatibility. The latest versions include improved fuzzy matching, better shell support, and enhanced third-party integrations.
        

⚡ Key Features of zoxide

🧠 Smart Learning

Learns your directory usage patterns and ranks them by frequency and recency. The more you visit a directory, the easier it becomes to access.

🔍 Fuzzy Matching

Jump to directories with partial matches. Type just a few characters and zoxide will find the right directory based on your history.

🐚 Universal Shell Support

Works with bash, zsh, fish, PowerShell, Nushell, Elvish, Tcsh, and Xonsh. Consistent experience across all major shells.

🔌 Rich Integrations

Native integration with fzf for interactive selection, plus plugins for Vim, Emacs, file managers, and tmux session managers.

📊 Data Import

Import existing data from autojump, z, z.lua, fasd, and other directory jumpers. No need to start from scratch.

⚙️ Highly Configurable

Customizable scoring algorithm, exclude patterns, aging settings, and command prefixes. Adapts to your workflow preferences.

🏆 Productivity Benefits

Save Time: Jump to any directory in 2-3 keystrokes instead of typing full paths
Reduce Errors: No more typos in long directory paths
Learn Patterns: Automatically adapts to your most-used directories
Cross-Session: Remembers directories across terminal sessions
Interactive Mode: Use with fzf for visual directory selection

🆕 What's New in zoxide 0.9.8+

Enhanced Algorithm: Improved scoring and ranking for better directory suggestions
Better Shell Integration: Enhanced support for modern shell features
Performance Improvements: Faster database operations and lookups
Extended Integrations: More third-party tool integrations and plugins
Configuration Options: Additional customization and environment variables
Cross-Platform: Better Windows, macOS, and Linux compatibility

📦 Installation from debian.griffo.io

Step 1: Add Repository

# Add GPG key
curl -sS https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg

# Add repository
echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list

# Update package list
sudo apt update
            

Step 2: Install zoxide

# Install latest zoxide
sudo apt install zoxide

# Verify installation
zoxide --version
            

Step 3: Set Up Shell Integration

# For bash users
echo 'eval "$(zoxide init bash)"' >> ~/.bashrc

# For zsh users  
echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc

# For fish users
echo 'zoxide init fish | source' >> ~/.config/fish/config.fish

# Reload shell
source ~/.bashrc  # or ~/.zshrc
            

🎯 Basic Usage Examples

Smart directory jumping:

# Jump to directory containing "projects"
z projects

# Jump to directory matching "my" and "app"
z my app

# Jump to subdirectory starting with "src"
z src/

# Go back to previous directory
z -

# Interactive selection with fzf
zi
        

Traditional cd still works:

# Regular cd functionality
z ~/Documents
z ../
z /usr/local/bin

# Relative paths
z ./src/components
        

Advanced features:

# Query directories without jumping
zoxide query projects

# Add directory manually
zoxide add /path/to/directory

# Remove directory from database
zoxide remove /path/to/directory

# Import from other tools
zoxide import --from=autojump ~/.local/share/autojump/autojump.txt
zoxide import --from=z ~/.z
        

Customization:

# Use different command prefix (j instead of z)
eval "$(zoxide init bash --cmd j)"

# Replace cd command entirely
eval "$(zoxide init bash --cmd cd)"

# Echo directory before jumping
export _ZO_ECHO=1

# Exclude certain directories
export _ZO_EXCLUDE_DIRS="$HOME:$HOME/private/*"
        

🚀 Why Choose debian.griffo.io?

📊 Repository Comparison:

Official Debian: Available but often outdated versions
Cargo Install: Requires Rust toolchain and compilation
Install Script: Manual updates and no package management
debian.griffo.io: Latest version (0.9.8+) with automatic updates

✅ Latest Algorithm: Get newest scoring and matching improvements
✅ No Rust Compilation: Pre-built binaries, no toolchain needed
✅ Automatic Updates: Packages updated within hours of upstream releases
✅ Complete Package: Includes shell integration and documentation
✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
✅ Easy Maintenance: Standard apt commands for updates

🔗 Related Packages

Also available from debian.griffo.io:

fzf Fuzzy Finder - Perfect companion for interactive zoxide selection
eza - Modern ls replacement for better directory listing
Yazi File Manager - Integrates with zoxide for smart navigation

            🎯 Perfect for: Developers who navigate complex directory structures, power users who want efficient terminal workflows, anyone tired of typing long paths, and users who appreciate intelligent automation in their tools.
        

📂 Install Latest zoxide on Debian