CI/CD Status Queries

Query CI/CD pipelines and check merge readiness across GitHub Actions and GitLab CI. All recipes use minimal field sets for token efficiency. Covers pipeline status, failing jobs, run logs, workflow management, and merge readiness assessment.

When to Use

• Checking CI status -- "are checks passing?", "what's failing?", pipeline status
• Watching CI runs -- wait for completion, fail-fast on errors
• Debugging failures -- view logs for failing jobs, identify flaky tests
• Assessing merge readiness -- all checks green, reviews approved, no conflicts
• Listing workflow runs -- recent pipelines, specific workflow history
• Configuring CI allowlists -- auto-approval patterns for read-only CI commands

Critical Rules

1. Use gh pr checks (not gh run) for current-branch CI status. The pr checks subcommand maps directly to the PR's required status checks.
2. Use glab ci status for current-branch CI in GitLab. It shows the pipeline for the current branch without needing a pipeline ID.
3. Always use --json with gh to filter output fields. Full JSON output wastes tokens.
4. Use commands exactly as shown in this skill. The commands below are designed to match auto-approval allowlist patterns. Improvising flags may trigger permission prompts.

---

Provider Detection

git remote get-url origin

| Remote URL contains | Provider | CLI | CI system | |------------------------------------|----------|--------|------------------| | github.com | GitHub | gh | GitHub Actions | | gitlab.com or self-hosted GitLab | GitLab | glab | GitLab CI |

If ambiguous or both present, ask the user.

---

CI Status (Current Branch)

GitHub:

gh pr checks --json name,state,conclusion,bucket

GitLab:

glab ci status

CI Status as JSON

GitHub:

gh pr checks --json name,state,conclusion,bucket

GitLab:

glab ci get

Watch Until Complete

GitHub:

gh pr checks --watch --fail-fast

GitLab:

glab ci status --live

Recent Pipeline/Workflow Runs

GitHub:

gh run list --json databaseId,displayTitle,status,conclusion,headBranch,event --limit 10

GitLab:

glab ci list

Specific Run Details

GitHub:

gh run view {run_id} --json jobs,status,conclusion,displayTitle

GitLab:

glab ci view {pipeline_id}

Run Logs

GitHub:

gh run view {run_id} --log-failed

GitLab:

glab ci trace {job_id}

---

Merge Readiness (Current Branch)

GitHub:

gh pr view --json mergeable,reviewDecision,statusCheckRollup,isDraft,mergeStateStatus

Fields:

• mergeable -- MERGEABLE, CONFLICTING, or UNKNOWN
• reviewDecision -- APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED, or empty
• isDraft -- boolean
• mergeStateStatus -- CLEAN, BLOCKED, BEHIND, DIRTY, UNSTABLE

GitLab:

glab mr view -F json | jq '{merge_status:.merge_status,conflicts:.has_conflicts,blocking:.blocking_discussions_resolved,draft:.draft}'

---

Variables and Secrets

GitHub:

gh variable list
gh secret list

GitLab:

glab variable list

---

CI Queries Reference

Reference: See references/ci-queries.md for advanced patterns: failing check extraction, required checks, workflow listing, cache management, rulesets.

---

Allowlist

Reference: See references/allowlist.md for tiered Bash(command:*) patterns covering all read-only CI operations -- safe to auto-approve in Claude Code settings.json or OpenCode config.