Installer la CLI BuildCaptain

La CLI BuildCaptain est un compagnon optionnel de l'app. Elle permet aux agents IA — Claude Code, Codex ou n'importe quel client MCP — de lister et de lancer les builds Jenkins que tu as explicitement autorisés dans l'app. La CLI ne parle jamais directement à Jenkins : chaque requête passe par l'app BuildCaptain sur le même Mac, qui applique tes règles par dépôt et peut exiger ton approbation avant tout lancement.

Installation avec Homebrew

Ouvre le Terminal et exécute :

brew install inuali/tap/buildcaptain

Pas encore de Homebrew ? Récupère-le sur brew.sh. Tu peux aussi télécharger le binaire depuis GitHub Releases et le placer toi-même dans ton PATH.

Connecter ton agent IA

Enregistre la CLI comme serveur MCP auprès de l'agent que tu utilises :

claude mcp add buildcaptain -- buildcaptain mcp
codex mcp add buildcaptain -- buildcaptain mcp

L'agent obtient trois outils : list_run_configurations, trigger_run et get_run_status. Les configurations restreintes à un dépôt Git ne sont visibles que quand l'agent travaille dans un checkout correspondant — il ne voit donc jamais que les builds que tu as autorisés pour ce projet. Les configurations marquées Any repository dans l'app sont disponibles partout.

trigger_run attend la fin du build et rapporte le résultat : un seul appel suffit donc en général à l'agent. Si le build tourne encore à la fin de l'attente, l'outil renvoie un run_id à passer à get_run_status.

Avant que ça fonctionne

• L'app BuildCaptain doit être installée. Si elle ne tourne pas, la CLI la démarre automatiquement en arrière-plan.
• Active la passerelle dans l'app : AI Agents → Enable local agent gateway.
• Ajoute au moins une configuration d'exécution pour ton dépôt dans le même panneau de réglages.

Essaie depuis le Terminal

Exécute ceci n'importe où :

buildcaptain configs

La commande affiche les configurations d'exécution disponibles dans le dossier courant : dans un checkout Git, tu obtiens les configurations de ce dépôt plus celles valables pour tout dépôt ; ailleurs, uniquement ces dernières. buildcaptain run <configuration> en lance une et attend le résultat, en affichant chaque changement d'état ; ajoute --no-wait pour revenir tout de suite à ton prompt. buildcaptain wait <run-id> reprend un build et bloque jusqu'à la fin ; buildcaptain status <run-id> le vérifie une seule fois. Sans ID, les deux portent sur le dernier build lancé.

Dépannage

• "BuildCaptain is not running or Agent Access is disabled." — ouvre l'app et active Enable local agent gateway.
• Les builds restreints à un dépôt manquent — la CLI identifie ton projet par son remote origin ; vérifie donc que tu es dans le bon checkout et que le remote Git de la configuration correspond. Tu travailles dans un fork dont l'origin diffère du dépôt configuré ? Définis BUILDCAPTAIN_REPO=github.com/acme/widgets (le dépôt configuré) dans ton shell ou ta configuration MCP.
• Aucune configuration listée du tout — vérifie que les configurations sont activées dans l'app.

La CLI est open source (MIT) : github.com/inuali/buildcaptain-cli.