Documentation

Projump is a macOS menu-bar app. You define your projects and which CLI to launch in each, and Projump turns them into shell functions. Type a keyword in your terminal and you land in the project with the tool already running.

Requires macOS and a zsh shell.

Installation

Install with Homebrew:

brew install --cask projump/projump/projump

Then launch Projump from your Applications or the menu bar. Builds are also on the GitHub releases.

Quick start

Open Projump from the menu bar, then open its window.
Add a project: point it at a folder, or let Projump discover projects by their CLAUDE.md or AGENTS.md.
Give it a keyword (for example acme) and a variant: the CLI to launch, such as Claude.
Projump writes a shell function to ~/.config/projump/projump.zsh. Make sure your ~/.zshrc sources it:

source ~/.config/projump/projump.zsh

Open a new terminal and type your keyword:

acme

You land in the project, with claude already running.

Variants and tools

Declare the CLIs you use once, in Settings > Available CLIs. Projump ships with Claude, Codex, Gemini, and OpenCode, and you can add any command on your PATH.

Each project can have several variants. A variant is a suffix plus a CLI, so one project can launch different tools.

acme      # cd into the project, run claude
acme-c    # cd into the project, run codex
acme-g    # cd into the project, run gemini

How it works

A project and its variants compile to plain shell functions in ~/.config/projump/projump.zsh:

acme() { cd "/Users/you/code/acme" && claude "$@"; }
acme-c() { cd "/Users/you/code/acme" && codex "$@"; }

Anything you pass is forwarded to the tool:

acme --model opus

No magic, no daemon. Just functions you can read, in a file you own.