SKILL.md
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.packagesincludeszoxide)
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.packagesincludeszoxide)
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
- [Installation](docs/10_installation.md)
- [Nix operations](docs/20_nix.md)
- [Atuin shell history](docs/52_atuin.md)