Instalar la CLI de BuildCaptain

La CLI de BuildCaptain es un complemento opcional de la app. Permite que los agentes de IA — Claude Code, Codex o cualquier cliente MCP — listen e inicien las builds de Jenkins que autorizaste explícitamente en la app. La CLI nunca habla directamente con Jenkins: cada solicitud pasa por la app BuildCaptain en el mismo Mac, que aplica tus reglas por repositorio y puede exigir tu aprobación antes de que se ejecute nada.

Instalación con Homebrew

Abre Terminal y ejecuta:

brew install inuali/tap/buildcaptain

¿Todavía no tienes Homebrew? Consíguelo en brew.sh. También puedes descargar el binario desde GitHub Releases y colocarlo tú mismo en tu PATH.

Conecta tu agente de IA

Registra la CLI como servidor MCP en el agente que uses:

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

El agente obtiene tres herramientas: list_run_configurations, trigger_run y get_run_status. Las configuraciones restringidas a un repositorio Git solo son visibles cuando el agente trabaja en un checkout que coincide, así que solo ve las builds que permitiste para ese proyecto. Las configuraciones marcadas como Any repository en la app están disponibles en cualquier parte.

trigger_run espera a que la build termine e informa del resultado, así que al agente le suele bastar una sola llamada. Si la build sigue en marcha cuando acaba la espera, la herramienta devuelve un run_id para get_run_status.

Antes de que funcione

• La app BuildCaptain debe estar instalada. Si no está en ejecución, la CLI la inicia automáticamente en segundo plano.
• Activa el gateway en la app: AI Agents → Enable local agent gateway.
• Añade al menos una configuración de ejecución para tu repositorio en el mismo panel de ajustes.

Pruébalo desde Terminal

Ejecuta esto en cualquier sitio:

buildcaptain configs

Imprime las configuraciones de ejecución disponibles en la carpeta actual: dentro de un checkout de Git obtienes las configuraciones de ese repositorio más las de cualquier repositorio; en otro lugar, solo las de cualquier repositorio. buildcaptain run <configuration> inicia una y espera el resultado, mostrando cada cambio de estado; añade --no-wait para volver enseguida al prompt. buildcaptain wait <run-id> retoma una build y bloquea hasta que termina; buildcaptain status <run-id> la comprueba una sola vez. Sin ID, ambos se refieren a la última ejecución.

Solución de problemas

• "BuildCaptain is not running or Agent Access is disabled." — abre la app y activa Enable local agent gateway.
• Faltan las builds restringidas a un repositorio — la CLI identifica tu proyecto por su remote origin, así que asegúrate de estar en el checkout correcto y de que el remote Git de la configuración coincida. ¿Trabajas en un fork cuyo origin difiere del repositorio configurado? Define BUILDCAPTAIN_REPO=github.com/acme/widgets (el repositorio configurado) en tu shell o en la configuración MCP.
• No se lista ninguna configuración — comprueba que las configuraciones estén activadas en la app.

La CLI es de código abierto (MIT): github.com/inuali/buildcaptain-cli.