Docs

How to set up, configure and run Mergepatrol, a merge queue for GitHub. The same text as the README.

Docs

• Get started with Mergepatrol

  Sign in with GitHub, install the App, merge the setup PR, add a model key, and label a pull request to queue it.

• How the merge queue works

  What a queued PR needs, the agent that resolves conflicts and fixes failed checks, automatic review, branches, batches, stacks and PRs from forks.

• Configuration: .mergepatrol/mergepatrol.yml

  Every setting in a repo's .mergepatrol/mergepatrol.yml: the label, batch size, the agent's model, verify commands, CI fixes, extra branches and review bars.

• Pricing

  Mergepatrol is free on public repos. Private repos cost $15 a seat a month after a 14-day trial with no card. Self-hosting is free.

• MCP server and API

  Let Claude Code, Codex or Cursor queue and review PRs through Mergepatrol's MCP server, or read a PR's queue state from the JSON API.

• Self-host Mergepatrol

  Run the open-source Mergepatrol yourself with Docker Compose, configure it, bring your own GitHub App, and isolate its jobs in gVisor sandboxes.