smithery/barleytea

zoxide-guide

Zoxide smart directory navigation configured via home-manager including usage examples and troubleshooting

Installation

$ npx skills add smithery/barleytea --skill zoxide-guide

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/barleytea.

npx skills add smithery/barleytea

Browse all from smithery/barleytea

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,582 B
  • docs SUMMARY.md 126 B

History

  1. First recorded snapshot · 0 installs

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.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
  1. Restart the shell:
exec zsh
  1. 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)