MergeMate — AI-powered pull request review and automation
Project description
MergeMate
AI-powered pull request review and automation.
MergeMate automates code review workflows by providing AI-generated feedback, suggestions, and documentation for pull requests. It integrates with major git providers and supports multiple AI models.
Why MergeMate?
- Fast & Efficient: Each tool (
/review,/improve,/ask) uses a single LLM call - Handles Any PR Size: Built-in compression strategy processes both small and large PRs
- Highly Customizable: Configuration-driven behavior via
.mergemate.toml - Platform Agnostic: GitHub, GitLab, Bitbucket, Azure DevOps, Gitea
- Multi-Model Support: OpenAI, Claude, Deepseek, and more
- Self-Hosted: Full control over your data and infrastructure
Quick Start
# AI-powered setup — auto-detects your project
mergemate-review init
# Or specify details
mergemate-review init --model deepseek/deepseek-v4-flash --language python --project-type web
This generates .mergemate.toml + GitHub Actions workflow. Add your API key as a repo secret, done.
Manual
# .github/workflows/mergemate.yml
name: MergeMate
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: mergemate/mergemate@main
env:
OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
CLI
pip install mergemate-review
export OPENAI_KEY=your_key_here
mergemate-review --pr_url https://github.com/owner/repo/pull/123 review
Docker
docker run -e OPENAI_KEY=$OPENAI_KEY \
mergemate/mergemate review \
--pr_url https://github.com/owner/repo/pull/123
Features
| Tool | Description |
|---|---|
/review |
Comprehensive PR review with inline suggestions |
/describe |
Auto-generate PR title and description |
/improve |
Code suggestions as review comments |
/ask |
Ask questions about the PR in context |
/update_changelog |
Update CHANGELOG based on PR contents |
/add_docs |
Generate documentation for changed code |
/generate_labels |
Auto-label PRs based on content |
/similar_issue |
Find related issues |
Platform Support
| GitHub | GitLab | Bitbucket | Azure DevOps | Gitea | |
|---|---|---|---|---|---|
| Review | ✅ | ✅ | ✅ | ✅ | ✅ |
| Describe | ✅ | ✅ | ✅ | ✅ | ✅ |
| Improve | ✅ | ✅ | ✅ | ✅ | ✅ |
| Ask | ✅ | ✅ | ✅ | ✅ | |
| CLI | ✅ | ✅ | ✅ | ✅ | ✅ |
| Webhook/App | ✅ | ✅ | ✅ | ✅ | ✅ |
Core Capabilities
- PR Compression: Adaptive file patch fitting for any PR size
- Dynamic Context: Automatically gather relevant project context
- Ticket Context: Fetch linked issue/ticket information
- Interactivity: Respond to comments and follow-up questions
- Self-Reflection: Review and improve its own output
- Multi-Model: Switch between AI providers via configuration
Configuration
MergeMate is configured via .mergemate.toml in your repository root. See mergemate/settings/configuration.toml for all available options.
[config]
model = "gpt-4"
git_provider = "github"
[pr_reviewer]
extra_instructions = "Focus on security and performance"
Data Privacy
MergeMate is self-hosted — your code never leaves your infrastructure. API calls go directly from your deployment to your chosen AI provider (OpenAI, Anthropic, etc.).
Contributing
See CONTRIBUTING.md for development setup and guidelines.
License
Proprietary. All rights reserved.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mergemate_review-1.0.9.tar.gz.
File metadata
- Download URL: mergemate_review-1.0.9.tar.gz
- Upload date:
- Size: 258.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
24d9fc30f948d4d32ed38a4eded41812eb31b7be80ce00a870de8dc7094068a5
|
|
| MD5 |
9c53a36e7feb5a32bcfe658c096c3322
|
|
| BLAKE2b-256 |
63f4a3c53dcbc17e55cc1a30ee535a19a01385bd9b6027a0e001526ef4cf9d5c
|
File details
Details for the file mergemate_review-1.0.9-py3-none-any.whl.
File metadata
- Download URL: mergemate_review-1.0.9-py3-none-any.whl
- Upload date:
- Size: 320.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
01c16d0d8d5e30a38bb854098738917ba6d69c657df1f2bd8383ae97cbd722f6
|
|
| MD5 |
7bd52c0c47f87ca587cc2615254e11e3
|
|
| BLAKE2b-256 |
cc6ad944493a46c887ec2ca7dc7e5b23c8763b02ce17570c1bbcc1aae22c65f8
|