<!-- markdownlint-configure-file { "MD013": { "code_blocks": false, "tables": false }, "MD033": false, "MD041": false } --> <div align="center">

^{Special thanks to:}

<table> <tr> <td align="center"> <!-- markdownlint-disable-next-line MD013 --> <a href="https://go.warp.dev/zoxide"><img alt="Sponsored by Warp" width="230" src="https://raw.githubusercontent.com/warpdotdev/brand-assets/refs/heads/main/Github/Sponsor/Warp-Github-LG-03.png" /></a> <div>^{<b>Warp, built for coding with multiple AI agents.</b>}</div> <div>^{Available for macOS, Linux, and Windows.}</div> <div>^{Visit <a href="https://go.warp.dev/zoxide"><u>warp.dev</u></a> to learn more.}</div> </td> <td align="center"> <!-- markdownlint-disable-next-line MD013 --> <a href="https://www.recall.ai/careers?ashby_jid=7b02811e-bc91-4ef2-925d-f56a5acac13b&utm_source=github&utm_medium=sponsorship&utm_campaign=zoxide"><img alt="Sponsored by Recall.ai" width="230" src="https://github.com/user-attachments/assets/0c5cb177-561c-4637-bef6-cf584939c829" /></a> <div>^{Processing over 3TB/s of video at peak load,}</div> <!-- markdownlint-disable-next-line MD013 --> <div>^{now <a href="https://www.recall.ai/careers?ashby_jid=7b02811e-bc91-4ef2-925d-f56a5acac13b&utm_source=github&utm_medium=sponsorship&utm_campaign=zoxide">hiring in SF.</a>}</div> </td> </tr> </table> <hr />

zoxide

[![crates.io][crates.io-badge]][crates.io] [![Downloads][downloads-badge]][releases] [![Built with Nix][builtwithnix-badge]][builtwithnix]

zoxide is a smarter cd command, inspired by z and autojump.

It remembers which directories you use most frequently, so you can "jump" to them in just a few keystrokes.<br /> zoxide works on all major shells.

Getting started • Installation • Configuration • Integrations

</div>

Getting started

![Tutorial][tutorial]

z foo              # cd into highest ranked directory matching foo
z foo bar          # cd into highest ranked directory matching foo and bar
z foo /            # cd into a subdirectory starting with foo

z ~/foo            # z also works like a regular cd command
z foo/             # cd into relative path
z ..               # cd one level up
z -                # cd into previous directory

zi foo             # cd with interactive selection (using fzf)

z foo<SPACE><TAB>  # show interactive completions (bash 4.4+/fish/zsh only)

Read more about the matching algorithm [here][algorithm-matching].

Installation

zoxide can be installed in 4 easy steps:

1. Install binary

   zoxide runs on most major platforms. If your platform isn't listed below, please [open an issue][issues].

   <details> <summary>Linux / WSL</summary>

   The recommended way to install zoxide is via the install script:

   curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
   

   Or, you can use a package manager:

   | Distribution | Repository | Instructions | | ------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------- | | Any | [crates.io] | cargo install zoxide --locked | | Any | [asdf] | asdf plugin add zoxide https://github.com/nyrst/asdf-zoxide.git <br /> asdf install zoxide latest | | Any | [conda-forge] | conda install -c conda-forge zoxide | | Any | [guix] | guix install zoxide | | Any | [Linuxbrew] | brew install zoxide | | Any | [nixpkgs] | nix-env -iA nixpkgs.zoxide | | Alpine Linux 3.13+ | [Alpine Linux Packages] | apk add zoxide | | Arch Linux | [Arch Linux Extra] | pacman -S zoxide | | ~Debian~[^1] | ~[Debian Packages]~ | ~apt install zoxide~ | | Devuan 4.0+ | [Devuan Packages] | apt install zoxide | | Exherbo Linux | [Exherbo packages] | cave resolve -x repository/rust <br /> cave resolve -x zoxide | | Fedora 32+ | [Fedora Packages] | dnf install zoxide | | Gentoo | [Gentoo Packages] | emerge app-shells/zoxide | | Manjaro | | pacman -S zoxide | | openSUSE Tumbleweed | [openSUSE Factory] | zypper install zoxide | | ~Parrot OS~[^1] | | ~apt install zoxide~ | | ~Raspbian~[^1] | ~[Raspbian Packages]~ | ~apt install zoxide~ | | Rhino Linux | [Pacstall Packages] | pacstall -I zoxide-deb | | Slackware 15.0+ | [SlackBuilds] | [Instructions][slackbuilds-howto] | | Solus | [Solus Packages] | eopkg install zoxide | | ~Ubuntu~[^1] | ~[Ubuntu Packages]~ | ~apt install zoxide~ | | Void Linux | [Void Linux Packages] | xbps-install -S zoxide |

   </details> <details> <summary>macOS</summary>

   To install zoxide, use a package manager:

   | Repository | Instructions | | --------------- | ----------------------------------------------------------------------------------------------------- | | [crates.io] | cargo install zoxide --locked | | [Homebrew] | brew install zoxide | | [asdf] | asdf plugin add zoxide https://github.com/nyrst/asdf-zoxide.git <br /> asdf install zoxide latest | | [conda-forge] | conda install -c conda-forge zoxide | | [MacPorts] | port install zoxide | | [nixpkgs] | nix-env -iA nixpkgs.zoxide |

   Or, run this command in your terminal:

   curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
   

   </details> <details> <summary>Windows</summary>

   zoxide works with PowerShell, as well as shells running in Cygwin, Git Bash, and MSYS2.

   The recommended way to install zoxide is via winget:

   winget install ajeetdsouza.zoxide
   

   Or, you can use an alternative package manager:

   | Repository | Instructions | | --------------- | ------------------------------------- | | [crates.io] | cargo install zoxide --locked | | [Chocolatey] | choco install zoxide | | [conda-forge] | conda install -c conda-forge zoxide | | [Scoop] | scoop install zoxide |

   If you're using Cygwin, Git Bash, or MSYS2, you can also use the install script:

   curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
   

   </details> <details> <summary>BSD</summary>

   To install zoxide, use a package manager:

   | Distribution | Repository | Instructions | | ------------- | --------------- | ------------------------------- | | Any | [crates.io] | cargo install zoxide --locked | | DragonFly BSD | [DPorts] | pkg install zoxide | | FreeBSD | [FreshPorts] | pkg install zoxide | | NetBSD | [pkgsrc] | pkgin install zoxide |

   Or, run this command in your terminal:

   curl -sS https://raw.githubusercon