await-ci
pipeline await-ci - Wait for CI workflows to complete for a specific commit
Wait for CI workflows to complete. Can wait by pattern+SHA or by run ID.
Mode 1 - Pattern+SHA (default): Polls GitHub Actions for in_progress or queued CI workflow runs that match the specified SHA and waits until all complete.
Mode 2 - Run ID: Wait for a specific workflow run to complete by its run ID.
SHA Detection (in order of precedence): 1. --sha flag (explicit override) 2. GITHUB_SHA environment variable (GitHub Actions) 3. git rev-parse HEAD (local development)
Flags
| Flag | Description |
|---|---|
--sha |
Commit SHA to filter runs (auto-detected if not provided) |
--run-id |
Specific workflow run ID to wait for (alternative to pattern+sha) |
--timeout (default: 1800) |
Maximum wait time in seconds (default: 1800) |
--interval (default: 30) |
Poll interval in seconds (default: 30) |
--pattern (default: ci-*.yaml) |
Workflow file pattern to match |
--exclude |
Workflow name substring to exclude (e.g., r2r-eac-bundle) |
Notes
Expected Output:
- Live progress display showing active workflow count
- Exit code 0 when all workflows complete successfully
- Exit code 1 on timeout or failure
Examples
pipeline await-ci # Auto-detect SHA, all ci-*.yaml
pipeline await-ci --sha abc123 # Explicit SHA
pipeline await-ci --pattern ci-r2r-cli.yaml # Specific workflow
pipeline await-ci --run-id 12345 # Wait for specific run
pipeline await-ci --timeout 600 # 10 minute timeout
pipeline await-ci --exclude ci-foo # Exclude workflow
See Also
Tutorials | How-to Guides | Explanation | Reference
You are here: Reference — information-oriented technical descriptions of the system.