How to Install zoxide on macOS

This guide will help you install zoxide on macOS using the most common methods.

Prerequisites

macOS 10.15 or later
Terminal access
Internet connection

Installation Methods

Method 1: Using Homebrew (Recommended)

The easiest way to install zoxide on macOS is using Homebrew:

If you don't have Homebrew installed, install it first:

Method 2: Using Cargo

If you have Rust installed, you can use Cargo:

Note: If you don't have Rust installed, you can install it using:

Method 3: Using Pre-built Binary

Download the pre-built binary from the zoxide releases page:

For Apple Silicon (M1/M2) Macs:

Shell Configuration

After installation, you need to initialize zoxide in your shell configuration file.

For Zsh (Default on macOS)

Add the following to your ~/.zshrc:

Then reload your shell:

For Bash

If you're using Bash, add to your ~/.bash_profile or ~/.bashrc:

Then reload your shell:

For Fish

If you're using Fish shell, add to your ~/.config/fish/config.fish:

Verify Installation

Test that zoxide is installed correctly:

You should see the version number printed.

Basic Usage

Once installed and configured, you can start using zoxide:

Troubleshooting

Command Not Found

If you get "command not found" after installation:

Check that zoxide is in your PATH:

If using Homebrew, make sure Homebrew's bin directory is in your PATH:

If using Cargo, add Cargo's bin directory to your PATH:

Permission Denied

If you get permission errors:

Make sure the binary is executable:

Or install to a user directory:

zoxide install macOS