Documentation

Projump est une app macOS de barre de menus. Vous définissez vos projets et le CLI à lancer dans chacun, et Projump les transforme en fonctions shell. Tapez un mot-clé dans votre terminal et vous arrivez dans le projet avec l'outil déjà lancé.

Prérequis : macOS et un shell zsh.

Installation

Installez via Homebrew :

brew install --cask projump/projump/projump

Lancez ensuite Projump depuis vos Applications ou la barre de menus. Les binaires sont aussi disponibles sur les releases GitHub.

Démarrage rapide

Ouvrez Projump depuis la barre de menus, puis sa fenêtre.
Ajoutez un projet : pointez un dossier, ou laissez Projump découvrir vos projets via leur CLAUDE.md ou AGENTS.md.
Donnez-lui un mot-clé (par exemple acme) et une variante : le CLI à lancer, par exemple Claude.
Projump écrit une fonction shell dans ~/.config/projump/projump.zsh. Vérifiez que votre ~/.zshrc la source :

source ~/.config/projump/projump.zsh

Ouvrez un nouveau terminal et tapez votre mot-clé :

acme

Vous arrivez dans le projet, avec claude déjà lancé.

Variantes et outils

Déclarez les CLI que vous utilisez une seule fois, dans Réglages > CLI disponibles. Projump est livré avec Claude, Codex, Gemini et OpenCode, et vous pouvez ajouter n'importe quelle commande de votre PATH.

Chaque projet peut avoir plusieurs variantes. Une variante, c'est un suffixe plus un CLI : un même projet lance ainsi différents outils.

acme      # cd dans le projet, lance claude
acme-c    # cd dans le projet, lance codex
acme-g    # cd dans le projet, lance gemini

Fonctionnement

Un projet et ses variantes se compilent en simples fonctions shell, dans ~/.config/projump/projump.zsh :

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

Tout ce que vous passez est transmis à l'outil :

acme --model opus

Pas de magie, pas de démon. Juste des fonctions lisibles, dans un fichier qui vous appartient.