AI-powered GitHub Actions failure analyzer. When your CI fails, it automatically reads the logs, identifies the root cause, and posts a detailed fix suggestion as a PR comment.

• Triggers automatically when a job in your workflow fails
• Fetches the raw logs of every failed job via the GitHub API
• Sends them to your chosen AI provider for structured analysis
• Posts a PR comment with root cause, failed steps, and a concrete fix
• Also writes to the GitHub Actions job summary (visible even without a PR)

Example PR comment:

Root Cause: The npm ci step failed because package-lock.json is out of sync with package.json. A dependency was likely added manually without running npm install.

Suggested Fix:

1. Run npm install locally
2. Commit the updated package-lock.json
3. Push and re-run the workflow

Pick one provider and get an API key from their platform:

1. Go to your repo → Settings → Secrets and variables → Actions
2. Click New repository secret
3. Add the secret for your chosen provider:

name: CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm test

  analyze-failure:
    runs-on: ubuntu-latest
    needs: [build]
    if: failure()
    permissions:
      actions: read
      pull-requests: write
    steps:
      - uses: Rutvik2598/github-logs-analyzer@v1.0.0
        with:
          provider: gemini                                    # or anthropic, openai, groq
          gemini-api-key: ${{ secrets.GEMINI_API_KEY }}      # match the secret to your provider

The github-token is set automatically — no extra setup needed.

The action needs these permissions on the job:

permissions:
  actions: read         # read workflow run logs
  pull-requests: write  # post the analysis as a PR comment

npm install         # install dependencies
npm run typecheck   # type check without building
npm run build       # compile + bundle to dist/index.js

After making changes to src/, always run npm run build and commit the updated dist/index.js — GitHub executes the bundled file directly.