DEV Community

Chris1220-cmd
Chris1220-cmd

Posted on

I built a GitHub Action that diagnoses CI failures using Claude AI

#ai #cicd #github #showdev

Every developer knows the feeling — your PR fails, you open
the CI logs, and you spend 20 minutes reading walls of text
trying to find what went wrong.

I built CI Fix Coach to fix that.

What it does

It's a GitHub Action that automatically reads your failed CI
logs and posts an actionable fix guide as a PR comment.

Every comment follows this format:

A. What failed — exact error description
B. Why — root cause explanation

C. Steps to fix — numbered list of actions
D. Local check — command to verify the fix
E. File to change — exact file and what to modify

Real example

Here's what your team sees after a failed ESLint check:

A. ESLint failed — 3 violations in api/users.js
B. var declarations and missing semicolons violate no-var and semi rules
C. Replace var→const/let, add semicolons on lines 12, 18, 34
D. npx eslint api/users.js --fix --dry-run
E. api/users.js — replace var declarations

Setup in 2 minutes

Add this to your workflow YAML:

  • name: CI Fix Coach uses: Chris1220-cmd/ci-fix-coach@v1 with: anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }} github-token: ${{ secrets.GITHUB_TOKEN }}

Key features

  • Diagnoses 14 failure types (ESLint, TypeScript, Docker, OOM, network errors, and more)
  • Per-job analysis — each failed job gets its own diagnosis
  • BYOK — uses your Anthropic API key (~$0.001 per diagnosis)
  • Open source, MIT license

GitHub: https://github.com/Chris1220-cmd/ci-fix-coach

Top comments (0)