Loop On Ci

This automates the tedious cycle of watching CI fail, reading logs, pushing fixes, and repeating until everything goes green. It uses `gh pr checks` as the source of truth since that captures all PR-attached checks, not just GitHub Actions. The workflow is sensible: it inspects checks before waiting, fails fast when something breaks, and re-checks the full set after every push since the check list can change. The guardrails are smart too, like merging main when failures look unrelated to your PR instead of piling on fixes for someone else's mess. If you've ever babysat a PR through five rounds of lint and test failures, this handles that loop for you.

skills.sh installs: 2.3K
GitHub stars: 15.9K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cursor/plugins --skill loop-on-ci --agent claude-code

Installs into .claude/skills of the current project.

Files

Loop on CI

Trigger

Need to watch a branch or pull request and iterate on CI failures until all required checks are green.

Use gh pr checks as the source of truth. It includes all PR-attached checks, while gh run list only covers GitHub Actions.

Workflow

Resolve the PR for the current branch.
Inspect current PR checks before waiting.
If checks already failed, diagnose those failures first.
If checks are pending, watch with gh pr checks --watch --fail-fast.
After each push, re-check the full PR check set and repeat until green.

Commands

# Resolve the active PR
gh pr view --json number,url,headRefName

# Inspect all attached checks
gh pr checks --json name,bucket,state,workflow,link

# Watch pending checks and fail fast
gh pr checks --watch --fail-fast

# GitHub Actions logs, when the failing check links to a GHA run
gh run view <run-id> --log-failed