proj‑jumper is a lightweight Z‑shell plugin that lets you jump straight into any project folder under a single development root -- perfect when that root lives on a removable drive.
proj listy # → /Volumes/dog_house/development/projects/listy
proj # fuzzy‑pick a project (needs fzf)
proj config ~/code # one‑time helper to set a different root
- Smart root check – warns if the volume isn't mounted instead of failing.
- One‑word
proj <name>– faster than typing long paths. - Interactive picker – choose from a fuzzy list when you just run
proj(uses fzf if available). - Tab completion –
proj sa<Tab>→proj savage. - Config helper –
proj config /pathaddsexport PROJ_DEV_ROOT=/pathto your.zshrc.
brew tap kikolator/proj
brew install proj-jumper# one‑time link
ln -s "$(brew --prefix)/opt/proj-jumper/share/proj-jumper" \
"${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/proj-jumper"
# add the plugin name to ~/.zshrc, then reload
plugins=(... proj-jumper)
source ~/.zshrc_proj‑jumper works with any Z‑plugin manager that honours
_.plugin.zshfiles,
but Homebrew is the only distribution channel for now.*
| Action | Command | Result |
|---|---|---|
| Jump to a project | proj savage |
cd into savage |
| Pick interactively | proj |
fuzzy list via fzf |
| List projects (no fzf) | proj |
prints directory names |
| Tab‑complete | proj li<Tab> |
expands to listy |
| Set a new root | proj config ~/code |
writes export PROJ_DEV_ROOT=~/code to .zshrc |
| Variable | Purpose |
|---|---|
PROJ_DEV_ROOT |
Override the default root ($HOME/development). |
- Zsh 5.0+
- Optional:
fzffor the interactive picker.
MIT © 2025 Kikolator