zoxide
A smarter cd command that learns your most-used directories for fast navigation across all major shells.
What is zoxide?
zoxide is a fast and intelligent directory navigation tool for the command line. It replaces the traditional `cd` command by learning which directories you access most frequently, allowing you to jump to them with minimal typing. It solves the problem of navigating deep or complex directory structures by providing quick, fuzzy-matched access to your most-used paths.
Developers, system administrators, and power users who spend significant time in the terminal and want to optimize their directory navigation workflow across various shells and platforms.
Developers choose zoxide for its exceptional speed, cross-shell compatibility, and seamless integration with existing tools. Its lightweight design, smart ranking algorithm, and ability to import data from other jump tools make it a practical upgrade over manual `cd` usage or older alternatives.
Overview
A smarter cd command. Supports all major shells.
Use Cases
Best For
- Quickly navigating to frequently accessed project directories
- Reducing keystrokes when working with deep nested folder structures
- Shell users who switch between Bash, Zsh, Fish, or PowerShell
- Importing existing directory history from autojump, z, or fasd
- Integrating directory jumping into file managers like ranger or nnn
- Enhancing terminal workflows with fuzzy finding via fzf integration
Not Ideal For
- Environments where shell modifications are prohibited or heavily restricted due to security policies
- Users who primarily navigate via graphical interfaces or IDEs with built-in project navigation tools
- Systems with ephemeral or containerized workspaces where directory paths are not persistent enough for the learning algorithm to be effective
Pros & Cons
Pros
Uses fuzzy matching and a smart ranking algorithm to jump to directories in milliseconds, as shown in the tutorial where typing partial names instantly matches frequent paths.
Initializes seamlessly with Bash, Zsh, Fish, PowerShell, and even POSIX shells via simple eval commands, making it versatile across terminal environments.
Natively integrates with popular file managers like ranger and nnn, editors like Vim and Neovim, and launchers like Alfred, extending utility beyond the shell.
Provides import commands for autojump, fasd, z, and other tools, allowing users to retain directory history without starting from scratch, as detailed in the installation section.
Cons
Requires adding eval commands to shell config files, which can be error-prone for novices and may conflict with existing aliases or functions, as noted in the initialization steps.
Interactive selection via 'zi' depends on fzf, which must be installed separately and meet a minimum version requirement (v0.51.0), adding complexity and potential versioning issues.
The smart aging algorithm excludes old entries by default, which might cause users to lose track of infrequently used but important directories in high-churn environments.
Frequently Asked Questions
Related Projects
BatA cat(1) clone with wings.
fdA simple, fast and user-friendly alternative to 'find'
nushellA new type of shell
fish-shellThe user-friendly command line shell.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.