zoxide

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

<div align="center">

<sup>Special thanks to:</sup>

<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><sup><b>Warp, built for coding with multiple AI agents.</b></sup></div>
      <div><sup>Available for macOS, Linux, and Windows.</sup></div>
      <div><sup>
        Visit
        <a href="https://go.warp.dev/zoxide"><u>warp.dev</u></a>
        to learn more.
      </sup></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><sup>Processing over 3TB/s of video at peak load,</sup></div>
      <!-- markdownlint-disable-next-line MD013 -->
      <div><sup>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></sup></div>
    </td>
  </tr>
</table>

<hr />

<h1>
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="./contrib/logo-dark.svg">
    <source media="(prefers-color-scheme: light)" srcset="./contrib/logo-light.svg">
    <img alt="zoxide logo" src="./contrib/logo-light.svg" height="128" width="128">
  </picture>
  <br />
  zoxide
</h1>

[![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](#getting-started) •
[Installation](#installation) •
[Configuration](#configuration) •
[Integrations](#third-party-integrations)

</div>

## Getting started

![Tutorial][tutorial]

```sh
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].

## Inst