Zoxide Setup

Install and configure zoxide for frecency-based directory navigation in zsh.

24|6|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/runpod/lazy-agent --skill zoxide-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Zoxide Setup
Source: https://github.com/runpod/lazy-agent/tree/main/skills/setup-zoxide
Command: npx skills add https://github.com/runpod/lazy-agent --skill zoxide-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the installation and configuration of zoxide, a command-line tool that intelligently navigates directories, significantly speeding up your workflow by learning your usage patterns.

Core Features & Use Cases

  • Intelligent Directory Navigation: Replaces traditional cd with a context-aware command that predicts your intended destination.
  • Frecency-Based Ranking: Prioritizes directories based on how frequently and recently you've visited them.
  • Interactive Selection: Provides an interactive mode to choose from multiple matching directories when ambiguity arises.
  • Use Case: Instead of typing cd ~/Developer/work/my-awesome-project, you can simply type z project or z awesome and be taken directly to the correct directory.

Quick Start

Install zoxide by running the command brew install zoxide and then add eval "$(zoxide init zsh)" to your ~/.zshrc file.

Frequently Asked Questions about Zoxide Setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make terminal directory navigation faster with frecency matching?

Terminal directory navigation becomes faster by installing zoxide, a command-line utility that uses frecency-based matching to intelligently predict your intended destination. It replaces traditional cd commands by learning your usage patterns and prioritizing recently and frequently visited directories.

What is the best way to replace cd with smarter shell commands?

The best way to replace cd with smarter shell commands is installing zoxide via `brew install zoxide` and adding `eval "$(zoxide init zsh)"` to your ~/.zshrc file. This enables intelligent directory prediction, allowing you to simply type partial directory names like `z project` instead of full paths.

Does zoxide support interactive selection when multiple directories match?

Yes, zoxide supports interactive selection to resolve ambiguity when multiple directories match your query. This feature provides an interactive mode allowing you to choose the correct destination from multiple matching directories, ensuring accurate navigation without typing full paths.

Can I use zoxide to navigate directories in zsh?

Yes, you can use zoxide to navigate directories in zsh by initializing it with `eval "$(zoxide init zsh)"` in your ~/.zshrc file. This integrates the frecency-based navigation tool directly into your zsh shell environment.

How do I install and configure zoxide step by step?

To install and configure zoxide step by step, first run `brew install zoxide` to install the utility, then add `eval "$(zoxide init zsh)"` to your ~/.zshrc file to configure shell integration. Restart your terminal to start using the `z` command for intelligent directory navigation.

Why use frecency-based ranking for terminal directory switching?

Frecency-based ranking improves terminal directory switching by combining frequency and recency metrics to prioritize your most relevant directories. This reduces typing significantly, allowing you to jump directly to deeply nested folders using simple partial keywords instead of entering full paths.