ci-status

CI Status

Monitor the GitHub Actions CI pipeline for the current branch. A feature is not done until CI passes.

Instructions

1. Identify the current branch, commit, and target repo:

BRANCH=$(git branch --show-current)
SHA=$(git rev-parse --short HEAD)
echo "Branch: $BRANCH | Commit: $SHA"

# Repo: explicit --repo owner/name, else derive from the current checkout's origin.
# gh repo view resolves the checkout's origin remote — the repo where the branch/PR lives.
# To override (e.g. when testing against a different fork), set REPO_OVERRIDE=owner/name.
if [ -n "$REPO_OVERRIDE" ]; then
  case "$REPO_OVERRIDE" in
    */*) REPO="$REPO_OVERRIDE" ;;
    *) echo "ERROR: --repo must be owner/name format (got '$REPO_OVERRIDE')"; exit 1 ;;
  esac
else
  REPO=$(gh repo view --json nameWithOwner --jq .nameWithOwner)
fi
[ -n "$REPO" ] || { echo "ERROR: could not derive repo — is gh authenticated? Try: gh auth login"; exit 1; }
echo "Repo: $REPO"

1. Prefer an open PR's checks (PR-first path):

Derive the PR number for the current branch. When multiple open PRs share the head branch (stacked PRs), the first/most-recent is used. An empty PR_NUMBER means no open PR and routes to the branch-runs fallback in steps 3–6.

PR_NUMBER=$(gh pr list --head "$BRANCH" --state open --repo "$REPO" \
  --json number --jq '.[0].number')

if [ -n "$PR_NUMBER" ]; then
  echo "Open PR found: #$PR_NUMBER — checking PR checks directly"
  gh pr checks "$PR_NUMBER" --repo "$REPO"
  # Also available: gh pr view "$PR_NUMBER" --repo "$REPO" --json statusCheckRollup
  # If gh pr checks returns no rows, report NO-RUN (see step 7 — no checks were triggered).
  # Exit here if the PR checks output is definitive (pass/fail visible).
  # Otherwise fall through to the branch-runs fallback below for more detail.
else
  echo "No open PR for branch $BRANCH — using branch-runs fallback"
fi

1. No-PR fallback: find the latest CI run for this branch:

gh api "repos/$REPO/actions/runs?branch=$BRANCH&per_page=1" \
  --jq '.workflow_runs[0] | {id: .id, status: .status, conclusion: .conclusion, head_sha: .head_sha[:7], name: .name}'