Quickstart

Pick the path that fits your needs:

Managed SaaS

Install the GitHub App, no infrastructure to manage. First 5 reviews free, then pay-as-you-go.

Self-Hosted

docker-compose up on your infrastructure, your LLM, always free.

Managed SaaS
Self-Hosted

Get started with Managed SaaS

No infrastructure to deploy. MergeWatch runs everything for you.

Install the GitHub App

Go to mergewatch.ai and click Install GitHub App. You will be redirected to GitHub to authorize MergeWatch.

Select your repositories

Choose All repositories or pick specific ones. Click Install.

Start with a single test repository. You can add more repos at any time from GitHub Settings > Applications > MergeWatch > Configure.

Open a pull request

Create or push a branch and open a pull request against any installed repository. MergeWatch picks it up automatically.What to expect:

The bot posts a review comment within 15–50 seconds (typical; larger diffs and cold starts can take longer)
The review includes a summary, file-by-file findings, and a 1–5 merge readiness score
Findings are posted as inline review comments on the changed lines

If you don’t see a review after 5 minutes, check the webhook delivery log in your GitHub App settings. See Troubleshooting for common issues.

Get started with Self-Hosted

Run MergeWatch on your own infrastructure with Docker. No AWS account required.

Prerequisites

You only need Docker. No cloud CLIs, no Node.js, no build tools.

Docker 24.0+ and Docker Compose 2.20+
A GitHub account with permission to create a GitHub App

Clone the repository

git clone https://github.com/santthosh/mergewatch.ai.git
cd mergewatch.ai

Configure environment variables

cp .env.example .env

Edit .env and fill in the required variables:

# GitHub App
GITHUB_APP_ID=your-app-id
GITHUB_PRIVATE_KEY=your-private-key
GITHUB_WEBHOOK_SECRET=your-webhook-secret

# GitHub OAuth (same App — OAuth Credentials section)
GITHUB_CLIENT_ID=Iv23ab...
GITHUB_CLIENT_SECRET=your-oauth-client-secret

# Dashboard auth (generate: openssl rand -base64 32)
NEXTAUTH_SECRET=random-32-byte-secret

# LLM provider
ANTHROPIC_API_KEY=sk-ant-...
LLM_MODEL=claude-sonnet-4-20250514

DATABASE_URL and PORT are handled automatically by docker-compose. The Postgres sidecar and the dashboard (on port 3001) are included.

Start MergeWatch

docker compose up -d

Verify the server is running:

docker compose logs mergewatch

Look for: Server listening on port 3000

MergeWatch listens for GitHub webhooks at /webhook on port 3000. Your webhook URL is:

https://your-domain.com/webhook

Running locally? Use ngrok or Cloudflare Tunnel to expose port 3000 to GitHub webhooks.

Configure this URL in your GitHub App settings under Webhook URL.

Install the GitHub App on your repositories

Go to GitHub Settings > Developer settings > GitHub Apps
Find your MergeWatch app and click Install App
Choose All repositories or select specific ones
Click Install

Open a pull request

Create or push a branch and open a pull request against any installed repository. MergeWatch picks it up automatically.What to expect:

The bot posts a review comment within 15–50 seconds (typical; larger diffs and cold starts can take longer)
The review includes a summary, file-by-file findings, and a 1–5 merge readiness score
Findings are posted as inline review comments on the changed lines

If you don’t see a review after 5 minutes, check the webhook delivery log in your GitHub App settings and the container logs with docker compose logs mergewatch. See Troubleshooting for common issues.

What happens next?

Configure review behavior

Tune sensitivity, skip paths, and add custom review instructions.

Choose an LLM provider

Anthropic (default), LiteLLM, Amazon Bedrock, or Ollama.

Explore the dashboard

View review history, token usage, and repository activity.

Overview

Self-Hosting

LLM Providers

Platform Guides

Configuration

GitHub App

Deployment

Dashboard

Managed SaaS

Reference

Managed SaaS

Self-Hosted

Get started with Managed SaaS

Get started with Self-Hosted

Prerequisites

What happens next?

Configure review behavior

Choose an LLM provider

Explore the dashboard

Overview

Self-Hosting

LLM Providers

Platform Guides

Configuration

GitHub App

Deployment

Dashboard

Managed SaaS

Reference

Managed SaaS

Self-Hosted

​Get started with Managed SaaS

​Get started with Self-Hosted

​Prerequisites

​What happens next?

Configure review behavior

Choose an LLM provider

Explore the dashboard

Get started with Managed SaaS

Get started with Self-Hosted

Prerequisites

What happens next?