gitlab-review-agent

# 🤖 AI Review Agent

<div align="center">
  <img src="https://img.shields.io/badge/go-1.25.5-00ADD8?style=for-the-badge&logo=go&logoColor=white" alt="Go Version">
  <img src="https://img.shields.io/badge/GitLab-330F55?style=for-the-badge&logo=gitlab&logoColor=white" alt="GitLab">
  <img src="https://img.shields.io/badge/LLM-OpenAI%20%7C%20Anthropic%20%7C%20Google-black?style=for-the-badge" alt="Multi-LLM">
  <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="License">
</div>

<br/>

> **More than just a `.patch` reader.** AI Review Agent is an autonomous, context-aware code review assistant designed natively for GitLab Merge Requests. It clones your repository, reads the codebase, checks historical conventions, and engages in technical debates—just like a Senior Developer.

---

## 🚀 Why AI Review Agent?

Most open-source AI reviewers simply pipe your git diff into an LLM and spit out generic advice. **We do things differently:**

- 🧠 **True Contextual Awareness:** We don't just read the diff. The agent is equipped with tools (`read_file`, `search_code`, `multi_diff`) to explore the actual codebase. If you modify a function signature, it can search where else it's used before commenting. No more "hallucinated" bugs.
- ♻️ **Self-Improving Feedback Loop:** The system learns your project's conventions. A background Cron job consolidates historical AI reviews and human feedback into a tailored "Repository Best Practices" rulebook.
- 🔀 **Robust Multi-LLM Routing:** Avoid vendor lock-in. Natively supports **OpenAI (GPT-4o)**, **Anthropic (Claude 3.7)**, and **Google (Gemini 2.0)** with load-balancing and fallback mechanisms. Mix and match models based on cost, rate limits, or language proficiency.
- 💻 **Interactive Local CLI:** Don't want to spam your team with AI comments? Run the agent locally via CLI. It performs a dry-run review, displays the findings in your terminal, and lets you interactively select exactly which comments to