CLI y bloqueo en CI

Un único comando sin dependencias inicia una suite, espera el veredicto y sale con un código que tu pipeline entiende. PASS despliega; FAIL bloquea; INCONCLUSIVE lo decides tú.

Escrito a partir del código · actualizado el 26 sept 2026 · ¿Falta algo o hay un error? Escríbenos

Instalación

La CLI es un único script de Node 22 sin dependencias, así que se ejecuta directamente desde el repositorio o desde npm:

npx @colvo/cli run --project <project id> --wait

Configuración

Opción / envSignificado
COLVO_API_KEYClave de backend (cak_…). Obligatoria.
COLVO_API_URLPor defecto https://colvo.app.
--projectId del proyecto. Obligatorio.
--buildId de la build del agente; por defecto, la del proyecto.
--scenariosClaves de plantilla separadas por comas; por defecto, toda la biblioteca.
--repeats1–5, por defecto 3.
--labelTexto libre que se muestra en la consola (p. ej. el commit).
--wait / --no-waitEspera el veredicto (por defecto) o solo inicia la ejecución.
--timeoutMinutos de espera, por defecto 15.
--inconclusive-exitCódigo de salida para INCONCLUSIVE: 0, 1 o 2 (por defecto).

Códigos de salida

CódigoSignificado
0PASS
1FAIL: un defecto demostrado; no despliegues
2INCONCLUSIVE: no es un defecto demostrado, pero no despliegues a ciegas (configurable)
3Error de uso, de API o de timeout (incluido el límite del plan 402)

GitHub Actions

name: colvo-gate
on: [push]
jobs:
  suite:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - name: Run the COLVO suite
        env:
          COLVO_API_KEY: ${{ secrets.COLVO_API_KEY }}
        run: npx @colvo/cli run --project ${{ vars.COLVO_PROJECT_ID }} --label "${{ github.sha }}" --wait

Apunta la build a un despliegue de staging de tu agente (una build cuyo endpoint sea la URL de preview) y el bloqueo se ejecutará en cada push. GitLab CI, CircleCI y una shell normal funcionan igual; lo único que importa es el código de salida.

← API de TestWebhooks →
CLI y bloqueo en CI · Docs · COLVO