CI/CD Status Queries

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

github.com

gh

gitlab.com

glab

CI Status (Current Branch)

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

glab ci status

CI Status as JSON

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

glab ci get

Watch Until Complete

gh pr checks --watch --fail-fast

glab ci status --live

Recent Pipeline/Workflow Runs

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

glab ci list

Specific Run Details

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

glab ci view {pipeline_id}

Run Logs

gh run view {run_id} --log-failed

glab ci trace {job_id}

Merge Readiness (Current Branch)

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

• mergeable

  --

  MERGEABLE

  ,

  CONFLICTING

  , or

  UNKNOWN

• reviewDecision

  --

  APPROVED

  ,

  CHANGES_REQUESTED

  ,

  REVIEW_REQUIRED

  , or empty

• isDraft

  -- boolean

• mergeStateStatus

  --

  CLEAN

  ,

  BLOCKED

  ,

  BEHIND

  ,

  DIRTY

  ,

  UNSTABLE

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

Variables and Secrets

gh variable list
gh secret list

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.