zoxide-guide

name	zoxide-guide
description	Zoxide smart directory navigation configured via home-manager including usage examples and troubleshooting

zoxide

zoxide is a smarter cd command that learns your most-used directories.

This repository enables zoxide for zsh via home-manager and loads it from the zsh tool config.

Configuration Location

macOS (darwin):

• zsh init: darwin/home-manager/shell/zsh/config/zoxide.zsh
• tool config symlink: darwin/home-manager/shell/zsh/default.nix (installs to ~/.config/zsh/config/tools/206-zoxide.zsh)
• package install: darwin/home-manager/default.nix (home.packages includes zoxide)

NixOS:

• zsh init: nixos/home-manager/shell/zsh/config/zoxide.zsh
• tool config symlink: nixos/home-manager/shell/zsh/default.nix (installs to ~/.config/zsh/config/tools/206-zoxide.zsh)
• package install: nixos/home-manager/default.nix (home.packages includes zoxide)

Usage

Basic - jump to a directory:

z <query>

Examples:

z dotfiles
z git
z src

List matches:

zoxide query <query>

Interactive selection (optional, requires fzf):

zoxide query -i

Troubleshooting

z command not found

1. Apply home-manager:

make home-manager-apply

2. Restart the shell:

exec zsh

3. Confirm zoxide is available:

command -v zoxide
zoxide --version

Related Documentation

• Installation
• Nix operations
• Atuin shell history