Outcome: You’ll jump to your most-used folders with short fuzzy commands like z proj instead of typing long paths.

Who this is for: Linux terminal users on bash, zsh, or fish who constantly hop between projects.

Time required: About 2 minutes.

Quick Answer

Install Zoxide, add one init line to your shell config, reload your shell, then use z keyword to jump to ranked directories and zi for interactive selection with fzf.

What this one trick does

Zoxide replaces repetitive cd /very/long/path habits with a fast frequency + recency ranked jump system. The more you visit a directory, the easier it is to jump back using partial names.

Prerequisites

  • Linux terminal (Ubuntu, Fedora, Arch, etc.)
  • bash, zsh, or fish shell
  • curl or your package manager
  • Optional: fzf for interactive selection with zi

Step-by-step: Set up Zoxide

  1. Install Zoxide.
    curl -sSfL https://raw.githubusercontent.com/ajeetdsouza/zoxide/main/install.sh | sh
    Expected check: zoxide --version returns a version number.
  2. Enable it in your shell.
    Bash: echo 'eval "$(zoxide init bash)"' >> ~/.bashrc
    Use zoxide init zsh for zsh or zoxide init fish | source for fish.
    Expected check: after reloading shell, z exists.
  3. Reload your config.
    source ~/.bashrc (or restart terminal).
    Expected check: type z shows a generated function.
  4. Try your first fuzzy jump.
    Run z proj or z docs.
    Expected check: terminal changes into best matching frequent directory.
  5. Use interactive mode.
    Run zi (or zi foo).
    Expected check: fuzzy menu appears and selection drops you into chosen path.
  6. Optional import from old tools.
    Run zoxide import --from=autojump if you used autojump.
    Expected check: familiar directories rank quickly.

Expected result checks

  • z <keyword> lands in likely target folder without full path typing
  • Frequent folders rise in ranking over time
  • zi offers interactive jumps when multiple matches exist

Common mistakes

  • Adding init for the wrong shell
  • Forgetting to reload shell after editing config
  • Expecting perfect ranking before building usage history
  • Using zi without fzf installed

Troubleshooting

  • z: command not found: verify init line in correct rc file and reload shell.
  • Poor matches: visit directories normally a few times, then retry.
  • Interactive picker not opening: install fzf and restart shell.
  • Inspect database: run zoxide query -l to list indexed paths.

Official references

CTA: Use Zoxide for one workday, then compare how often you type full paths. Most Linux users don’t go back to plain cd for project switching.