Skip to main content

MergeMate — AI-powered pull request review and automation

Project description

MergeMate

Tests Docs Python 3.12+

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-chat --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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mergemate_review-1.0.3.tar.gz (257.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mergemate_review-1.0.3-py3-none-any.whl (318.7 kB view details)

Uploaded Python 3

File details

Details for the file mergemate_review-1.0.3.tar.gz.

File metadata

  • Download URL: mergemate_review-1.0.3.tar.gz
  • Upload date:
  • Size: 257.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for mergemate_review-1.0.3.tar.gz
Algorithm Hash digest
SHA256 86c2f96f3e43ca4456d464a3cb58e853385eaf7025fe3e95263250daae4c6327
MD5 9ecaecb4d8cf7b0ebe31ab8c8e2eecd2
BLAKE2b-256 dde016f52bf05b25f4d699f0f10011a6b722ca135926426b0465ca21ce57a147

See more details on using hashes here.

File details

Details for the file mergemate_review-1.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for mergemate_review-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 40860e7acd3604871f438d22f79fe92136cdc5ccfc82a5bb5e4bd8574b8817f6
MD5 97d0119ffe3cc7aaef18043bb580cb57
BLAKE2b-256 f6ebc7163535d09aafce39c7c5d694e6e9aca6135584f73a6d21a0946a2f4dc9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page