---
source_url: "https://github.com/marketplace/actions/ai-ci-healer"
title: AI CI Healer · Actions · GitHub Marketplace · GitHub
mirrored_at: 2026-08-13T01:01:51.811Z
host: github.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/github.com/marketplace/actions/ai-ci-healer"
---

> **Original source:** https://github.com/marketplace/actions/ai-ci-healer

   

**Stop Googling build errors. Let AI fix them for you.**

When your GitHub Actions fail, **AI CI Healer** analyzes the logs, finds the root cause (using Groq, Gemini, or Ollama), and posts the **exact fix** directly to your PR or commit.

* * *

## ✨ Features

-   **🧠 Multi-Brain Support:** Choose between **Groq** (Fastest), **Gemini** (Smartest), or **Ollama** (Private/Local).
-   **🛡️ Smart Fallback:** Automatically tries alternative providers if one API fails.
-   **👁️ Chain of Thought:** Expands the "Reasoning" dropdown to show _why_ the AI chose the fix.
-   **⚡ Blazing Fast:** Zero-config setup. Drops into any workflow in seconds.
-   **🔒 Enterprise Ready:** Works with private repositories and self-hosted runners.

* * *

## 🚀 Quick Start

Add this step to your workflow file (e.g., `.github/workflows/ci.yml`) **after** your build/test steps.

> **Note:** The `if: failure()` line is crucial. It ensures the Healer only runs when something breaks.

\- name: Run Tests
  run: npm test

# 👇 Add this step to auto-heal failures
- name: AI CI Healer
  if: failure()
  uses: mariorazo97/ai-ci-healer@v1
  with:
    github-token: ${{ secrets.GITHUB\_TOKEN }}
    llm-provider: "groq"
    groq-api-key: ${{ secrets.GROQ\_API\_KEY }}

* * *

## ⚙️ Configuration

### Action Inputs

Input

Description

Default

Required

`github-token`

GitHub token for posting comments

`${{ secrets.GITHUB_TOKEN }}`

✅ Yes

`llm-provider`

AI provider: `groq`, `gemini`, or `ollama`

`groq`

No

`groq-api-key`

Groq API key ([Get free key](https://console.groq.com/))

\-

If using Groq

`gemini-api-key`

Gemini API key ([Get free key](https://ai.google.dev/))

\-

If using Gemini

`ollama-endpoint`

Self-hosted Ollama URL (e.g., `http://localhost:11434`)

\-

If using Ollama

`enable-comments`

Enable/disable PR commenting

`true`

No

`confidence-threshold`

Minimum confidence to post (0-100)

`50`

No

`max-log-lines`

Maximum log lines to analyze

`500`

No

`custom-context`

Team-specific rules (e.g., "Use TypeScript strict mode")

`""`

No

### Example Configuration

\- name: AI CI Healer
  if: failure()
  uses: your-username/ai-ci-healer@v1
  with:
    github-token: ${{ secrets.GITHUB\_TOKEN }}
    llm-provider: groq
    groq-api-key: ${{ secrets.GROQ\_API\_KEY }}
    confidence-threshold: 60
    custom-context: |
      Our team conventions:
      - Always use TypeScript strict mode
      - Prefer async/await over promises
      - Follow Airbnb style guide

* * *

## 🔒 Security & Privacy

We take your code security seriously:

-   **🚫 Zero Data Retention**: Your code is never stored. Logs are sent to the AI provider only for analysis and immediately discarded.
-   **🔍 Fully Transparent**: Audit the entire source code in [`src/`](https://github.com/mariorazo97/ai-ci-healer/blob/main/src) to see exactly what data is transmitted.
-   **🏠 Self-Hosted Option**: Use the `ollama` provider to keep 100% of your data on your own infrastructure—no external API calls.
-   **🔐 API Keys**: All API keys are stored securely in GitHub Secrets and never logged or exposed.

> **Note**: When using Groq or Gemini, error logs are sent to their APIs for analysis. Read their privacy policies: [Groq](https://groq.com/privacy-policy/) | [Gemini](https://ai.google.dev/gemini-api/terms)

* * *

## 🤝 Contributing

We love contributions! Here's how you can help:

### Quick Start

1.  🍴 Fork the repository
2.  🌿 Create your feature branch (`git checkout -b feature/amazing-feature`)
3.  ✍️ Commit your changes (`git commit -m 'feat: add amazing feature'`)
4.  🚀 Push to the branch (`git push origin feature/amazing-feature`)
5.  🎉 Open a Pull Request

### Ways to Contribute

-   🐛 Report bugs in [Issues](https://github.com/mariorazo97/ai-ci-healer/issues)
-   💡 Suggest features in [Discussions](https://github.com/mariorazo97/ai-ci-healer/discussions)
-   📝 Improve documentation
-   🌍 Add support for new languages
-   ⚡ Optimize performance
-   ✅ Write tests

Read our [**CONTRIBUTING.md**](https://github.com/mariorazo97/ai-ci-healer/blob/main/CONTRIBUTING.md) for detailed guidelines.

* * *

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](https://github.com/mariorazo97/ai-ci-healer/blob/main/LICENSE) file for details.

* * *

## ⭐ Show Your Support

If AI CI Healer saved you time and frustration, consider:

### Give it a star ⭐

### Buy me a coffee ☕

### Follow for updates 📢

 

* * *