CLI

Installation

Install with a single command:

This downloads the latest binary for your platform (macOS or Linux) and places it on your PATH.

Authentication

Before using the CLI, authenticate with your API key. Create one in Settings > API Keys with read scope (add write scope if you want to trigger reruns).

You'll be prompted to paste your API key. The key is stored locally in ~/.config/cicdwatch/config.json.

Commands

cicdwatch status

Show the current status of your pipelines. See which workflows are passing, failing, or still running at a glance.

$ cicdwatch status

 REPO                  WORKFLOW          STATUS    DURATION
 acme/api              CI                ✓ pass    2m 14s
 acme/api              Deploy Staging    ● running 1m 03s
 acme/web              Build & Test      ✗ fail    4m 52s
 acme/infra            Terraform Plan    ✓ pass    0m 48s

Options

--repo, -r

Filter by repository name or pattern

--branch, -b

Filter by branch name

--failed

Show only failed pipelines

--watch, -w

Continuously refresh the status view

cicdwatch logs

Stream build logs in real time. Tail logs from running workflows or view completed build output directly in your terminal.

$ cicdwatch logs acme/web --workflow "Build & Test"

[Build & Test #847] Step 1/4: Checkout
  ✓ Cloned repository (0.8s)
[Build & Test #847] Step 2/4: Install
  ✓ npm ci (12.3s)
[Build & Test #847] Step 3/4: Test
  ✗ 2 tests failed (4m 18s)
    FAIL src/auth.test.ts - timeout waiting for response

Options

--workflow

Filter by workflow name

--follow, -f

Follow log output as it streams

--run

View logs for a specific run number

cicdwatch rerun

Re-run failed or flaky workflows with a single command. Requires an API key with write scope.

$ cicdwatch rerun acme/web --workflow "Build & Test"

Re-running Build & Test #847 for acme/web...
✓ Workflow triggered successfully. Run #848 started.

Options

--workflow

Specify the workflow to rerun

--failed-only

Only rerun failed jobs within the workflow

cicdwatch connections

List your connected CI/CD providers and their sync status.

$ cicdwatch connections

 PROVIDER         REPOS   LAST SYNC         STATUS
 GitHub Actions   12      2 minutes ago     ✓ healthy
 GitLab CI        4       5 minutes ago     ✓ healthy
 CircleCI         3       3 minutes ago     ✓ healthy

Global Options

These options are available on all commands:

Updating

To update to the latest version, run the install command again:

The installer detects your existing installation and replaces it with the latest version.

Uninstalling

Remove the binary and config:

rm $(which cicdwatch)
rm -rf ~/.config/cicdwatch

See Also

• Public API — the REST API that powers the CLI
• MCP Server — query pipeline data from AI assistants
• Settings — manage API keys and team configuration