Skip to main content

​
Prerequisites

Before you start, make sure you have:
Node.js 20 or later
AWS CLI installed and configured with credentials
SAM CLI installed
An AWS account with Amazon Bedrock enabled
Bedrock model access granted for Claude Sonnet
1

Run the install wizard

npx mergewatch@latest init
The wizard handles everything:
  1. Creates a GitHub App via the manifest flow (your browser opens automatically)
  2. Stores credentials in AWS SSM Parameter Store
  3. Deploys the stack using SAM (Lambda, API Gateway, DynamoDB)
  4. Prints the webhook URL when finished
The entire process takes about 5 minutes. You will be prompted to authenticate with GitHub and confirm the AWS deployment.
2

Install on your repos

After the wizard completes, install the GitHub App on the repositories you want reviewed:
  1. Go to your GitHub App’s installation page (the wizard prints this URL)
  2. Select All repositories or pick specific ones
  3. Click Install
Start with a single test repository. You can add more repos at any time from GitHub Settings > Applications.
3

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 comment within 1-3 minutes
  • The review includes a summary, file-by-file findings, and a risk rating
  • Findings are posted as inline review comments on the relevant lines
If you don’t see a review after 5 minutes, check the webhook delivery log in your GitHub App settings and the Lambda logs in CloudWatch. See Troubleshooting for common issues.

​
What happens next?

Explore the dashboard

View review history, token usage, and repository activity.

Configure review behavior

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

Set up BYOC

Bring Your Own Cloud — point MergeWatch at your own Bedrock account for full control over model access and costs.