MergeGuard

Smart, policy-driven pull request automation for GitHub

MergeGuard adds a flexible policy layer on top of GitHub pull requests, enabling conditional approvals, context-aware required checks, and intelligent merge automation—all configured through a single YAML file in your repository.

🎯 Why MergeGuard?

Understand the problem MergeGuard solves and how it extends GitHub's native capabilities.

🚀 Quickstart

Get started in minutes with basic configuration and examples.

✨ Features

Explore all available features and how to use them.

💰 Billing

Pricing information and plans.

What MergeGuard Does

  • ✅ Conditional Approvals - Require different reviewers based on files changed, PR size, labels, and more
  • ✅ Context-Aware Checks - Only run expensive CI when needed, saving time and money
  • ✅ Auto-Approval & Auto-Merge - Automate trusted updates (e.g., Dependabot patches)
  • ✅ PR Dependencies - Enforce merge order for stacked or dependent PRs
  • ✅ Priority-Based Rules - Multiple rules can match; priority decides which applies
  • ✅ GitHub-Native - Works seamlessly with GitHub Checks, no external dependencies

Example Configuration

rules:
  - name: "Small changes"
    if:
      maxLocChanged: 10
      excludePaths: ["infra/**"]
    require:
      approvals: 1
    action:
      autoApprove: true

  - name: "Infrastructure changes"
    if:
      paths: ["infra/**"]
    require:
      approvals: 2
      teams: ["platform-team"]
      checks:
        - "terraform-validate"
        - "security-scan"

Ready to Get Started?

Install MergeGuard on your GitHub repository and add a .github/mergeguard.yml file.

Need help? Check out the Quickstart Guide or browse the Features.