Getting Started

Introduction

OpenMerge is an AI-powered GitHub PR reviewer. Install it as a GitHub App, and it automatically reviews every pull request using three specialized agents.

Overview

OpenMerge connects to your GitHub repositories via a GitHub App and reviews pull requests automatically. When a PR is opened, OpenMerge runs security, performance, and code quality agents in parallel, then posts inline comments directly on the diff — exactly like a senior engineer would.

Key capabilities

• •Multi-agent parallel review: Three specialized agents run simultaneously on every PR — no sequential bottleneck.
• •Inline diff comments: AI findings are posted as line-level review comments, not a separate report.
• •GitHub App integration: Installs in 30 seconds. Webhooks trigger reviews automatically on every PR.
• •Configurable rules: Ignore paths, adjust severity thresholds, and disable specific agents per repository.

How OpenMerge Works

When a pull request is opened or updated, GitHub sends a webhook to OpenMerge. The server validates the signature, creates a review job, and queues it for the worker.

The worker dequeues the job and runs three agents in parallel:

• —The Code Quality Agent checks for bugs, dead code, naming issues, and style violations.
• —The Security Agent scans for injection risks, exposed secrets, insecure dependencies, and OWASP top 10 patterns.
• —The Performance Agent identifies N+1 queries, unnecessary allocations, and algorithmic complexity issues.

After all agents complete, findings are aggregated and posted as inline comments on the PR diff via the OpenMerge bot account.

Installation

Install the OpenMerge GitHub App in three steps:

1. 1.Visit the GitHub Marketplace and install the OpenMerge GitHub App.
2. 2.Authorize OpenMerge and select the repositories to review.
3. 3.Open a pull request — OpenMerge will post a review automatically.

Configuration

Add a .openmerge.yml file to the root of your repository to configure review behavior:

agents:
  code_quality: true
  security: true
  performance: true

ignore:
  - "**/*.test.ts"
  - "migrations/**"
  - "*.generated.*"

severity_threshold: warning

See the Agents & Rules page for all available configuration options.