claude-jump

Jump to any project (interactive menu, ranked by how often/recently you use it) and launch Claude Code in one command — instead of cd-ing there by hand every time.

Built on zoxide (recent/frequent directory tracking) and fzf (fuzzy interactive menu).

Install

npm i -g claude-jump
# or
pnpm add -g claude-jump
# or
bun add -g claude-jump

This installs the cj, cj-scan and cj-setup commands globally, and runs a setup step that installs fzf and zoxide if missing (via Homebrew / apt / dnf / pacman) and adds the zoxide shell hook to your rc file (zsh or bash).

pnpm and bun block install scripts by default for security, so the setup step may not run automatically. If cj doesn't work after install, run the setup manually:

cj-setup

Then restart your terminal, or run source ~/.zshrc (or ~/.bashrc).

Usage

cj              # interactive menu of your projects, launches Claude Code in the one you pick
cj myproject    # jump straight to the best match for "myproject", no menu

The project list starts empty and fills up naturally as you cd around (that's what zoxide tracks). To seed it immediately with your existing projects:

cj-scan ~/Desktop ~/Documents   # finds every git repo under these paths and adds it to the list
cj-scan                         # defaults to scanning the current directory

Uninstall

npm uninstall -g claude-jump
# or
pnpm remove -g claude-jump
# or
bun remove -g claude-jump

This removes the cj, cj-scan and cj-setup commands and the zoxide hook block from your shell rc file. fzf and zoxide themselves are left installed since other tools may use them.

How it works

• zoxide maintains a frecency-ranked (frequency + recency) database of directories you visit.
• cj opens that list through fzf for a fuzzy interactive pick, then launches claude in that directory.
• cj <name> skips the menu and jumps to zoxide's best match directly.
• cj is a real binary (bin/cj.js), so quitting Claude Code leaves you back where you started — it doesn't persist a cd in your shell.

License

MIT