Ci Failure Fixer
/install ci-failure-fixer
CI Failure Fixer
Monitor GitHub Actions for failures. Auto-fix what's fixable, report what's not.
How It Works
scripts/check-ci-failures.shpolls repos for new failed runs- If failures found → read build logs via
gh run view --log - Match error against known patterns → auto-fix if safe
- Push fix → wait 90s → verify build passes
- Report results (fixed or diagnosis-only)
Quick Start
On-demand
bash scripts/check-ci-failures.sh
Output: OK (no failures) or FAILURES with details.
As Cron Job (OpenClaw)
Set up a cron that runs every 30 minutes:
- Script:
bash scripts/check-ci-failures.sh - Model: Haiku (cheap, sufficient)
- On failure: Read logs, attempt auto-fix, report
Configuration
Environment variables:
GITHUB_OWNER— GitHub username (auto-detected fromghif not set)CI_REPOS— Space-separated repo names (auto-discovers all repos if not set)CI_STATE_FILE— Path to state JSON (tracks last check time)
Auto-Fixable Patterns
| Pattern | Detection | Fix |
|---|---|---|
| Dependency issues | npm ERR! Could not resolve |
npm install + push |
| Test snapshots | Snapshot mismatch |
npm test -- --update + push |
| Lint errors | eslint, Formatting |
eslint --fix + push |
| E2E snapshots | Playwright snapshot diff | playwright --update-snapshots + push |
Report-Only (Human Needed)
- Token/auth errors (secrets rotation)
- TypeScript errors (complex type issues)
- Build timeouts (resource/loop issues)
- Unknown errors
Fix Patterns Reference
Read references/fix-patterns.md for detailed decision tree, log reading commands, and all known patterns with fix scripts.
Reading Logs
# Latest failed run logs
gh run view --repo OWNER/REPO --log 2>&1 | tail -50
# Filter for errors
gh run view \x3Crun-id> --repo OWNER/REPO --log 2>&1 | grep -A5 "error\|FAIL"
After Fixing
Always verify the fix worked:
sleep 90 # Wait for new CI run
gh run list --repo OWNER/REPO --limit 1 --json conclusion -q '.[0].conclusion'
# Should be "success"
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ci-failure-fixer - After installation, invoke the skill by name or use
/ci-failure-fixer - Provide required inputs per the skill's parameter spec and get structured output
What is Ci Failure Fixer?
Monitor GitHub Actions CI pipelines for failures and automatically fix common issues. Use when asked to watch CI, fix build failures, monitor GitHub Actions,... It is an AI Agent Skill for Claude Code / OpenClaw, with 99 downloads so far.
How do I install Ci Failure Fixer?
Run "/install ci-failure-fixer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ci Failure Fixer free?
Yes, Ci Failure Fixer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Ci Failure Fixer support?
Ci Failure Fixer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ci Failure Fixer?
It is built and maintained by DanielGrobelny (@danielgrobelny); the current version is v1.0.0.