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 use most frequently, allowing you to jump to them with minimal typing. It solves the problem of navigating deep or frequently accessed directory structures efficiently, using a ranking algorithm based on usage frequency and recency.
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 smart learning algorithm requires no manual configuration, and it can import data from other directory jumpers, making adoption frictionless.
Overview
A smarter cd command. Supports all major shells.
Use Cases
Best For
- Quickly navigating to frequently used project directories
- Reducing keystrokes when working with deep directory trees
- Users switching between multiple shells who want consistent navigation
- Migrating from autojump, z, or similar tools without losing history
- Integrating directory jumping into file managers like ranger or nnn
- Enhancing terminal workflows with fuzzy finding and interactive selection
Not Ideal For
- Users who navigate primarily via GUI file managers and rarely use the terminal command line
- Systems with stringent security policies that prohibit installing and executing third-party shell extensions or daemons
- Environments where shell initialization speed is micro-optimized and any overhead from additional tools is unacceptable
- Projects requiring directory navigation based on complex metadata, tags, or non-frequency-based algorithms
Pros & Cons
Pros
Uses a smart algorithm to rank directories by frequency and recency, allowing jumps with partial names—demonstrated in the tutorial where 'z foo' navigates to the best match without full paths.
Works across Bash, Zsh, Fish, PowerShell, Nushell, and more with simple initialization scripts provided for each, ensuring broad compatibility as listed in the installation section.
Imports history from popular tools like autojump, fasd, and z, with detailed commands for each, easing transition without losing learned directories.
Integrates natively or via plugins with file managers (e.g., ranger, nnn), editors (Vim/Neovim), and launchers (Alfred, Raycast), expanding utility beyond basic shell navigation.
Cons
Full interactive features (zi) and tab completions require fzf installation, adding an extra step and potential compatibility issues if fzf is not available or outdated.
Has minimum version requirements for some shells, such as Nushell v0.89.0+ and Elvish v0.18.0+, which may not be met in older or stable system distributions.
Setup involves editing shell config files and managing environment variables (e.g., _ZO_EXCLUDE_DIRS), which can be error-prone for users unfamiliar with shell customization.
Frequently Asked Questions
Related Projects
oh-my-zsh🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140+ themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.
fuckMagnificent app which corrects your previous console command.
NVMNode Version Manager - POSIX-compliant bash script to manage multiple active node.js versions. $nvm: 3ArcxqLtXMmBnWbbtfwQgVL3MNnDsggzgGDtXMnjpump
Stirling-PDF#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
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.