MR Review¶
AI-powered merge request review tool that runs entirely on your machine — no cloud infrastructure required.
Browse GitLab or GitHub MRs, send the diff to an AI, edit the generated comments, and post them back to the MR in one continuous flow.
How it works¶
| Stage | What happens |
|---|---|
| PICK | Open an MR, browse the diff, pin lines you want the AI to focus on |
| BRIEF | Choose a review preset, toggle context sections, add custom instructions |
| DISPATCH | Send the diff to the AI — comments stream in as they are generated |
| POLISH | Edit, keep, or dismiss each generated comment |
| POST | Submit approved comments back to the MR as inline review comments |
Why mr-review¶
- No cloud infrastructure — runs on your machine with a single
docker compose up - GitLab and GitHub — connect self-hosted instances and cloud accounts simultaneously
- Any AI model — Claude, OpenAI, Ollama, Groq, and any OpenAI-compatible endpoint
- Streaming output — comments appear as the AI writes them, no waiting for the full response
- Local storage — host config and review history in SQLite, nothing leaves your machine except the diff you send
Get started¶
- Install — Docker is the only prerequisite
- Quick start — add an AI provider and a VCS host, run your first review
- Configuration — ports, data directory, CORS, log level
Features¶
- Review pipeline — detailed walkthrough of each stage
- VCS hosts — connecting GitLab and GitHub, token scopes
- AI providers — Claude, OpenAI, Ollama, and compatible APIs
Changelog¶
See changelog for release notes.