| 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
- Apply home-manager:
make home-manager-apply
- Restart the shell:
exec zsh
- Confirm zoxide is available:
command -v zoxide
zoxide --version
Related Documentation
