Skip to main content

​
Who can install

Only GitHub Organization owners can install GitHub Apps. Organization admins do not have permission to install apps — GitHub enforces this restriction at the platform level.If you are not an owner, ask an organization owner to install MergeWatch on your behalf.

​
Installation steps

1

Run the install wizard

npx mergewatch@latest init
The wizard walks you through creating the GitHub App and prints the installation URL when finished.
2

Open the installation URL

Open the URL printed by the wizard in your browser. It follows this format:
https://github.com/apps/mergewatch-{slug}/installations/new
3

Select the organization

GitHub displays a list of organizations you own. Select the organization where you want to install MergeWatch.
4

Choose repository scope

Select one of:
  • All repositories — MergeWatch reviews PRs across every repo in the org.
  • Only select repositories — Pick specific repos to include.
5

Click Install

Click Install to complete the installation. GitHub redirects you back to MergeWatch.
Start with Only select repositories and add a single test repo. Expand coverage after you have confirmed the review quality meets your expectations. You can switch to All repositories at any time from GitHub Settings > Applications > MergeWatch > Configure.

​
What happens after install

Once you click Install, the following happens automatically:
  1. GitHub fires an installation webhook to MergeWatch.
  2. MergeWatch creates an installation record in DynamoDB.
  3. An installation_repositories event fires for each repo in scope.
  4. All repos appear in Dashboard > Repositories within 30 seconds.
No review runs until a pull request is opened. Installing the app does not trigger reviews on existing PRs.

​
Multiple admins

Any organization owner can access the MergeWatch dashboard settings for that org. The account that ran npx mergewatch@latest init does not receive any special privileges — admin access is checked live against the GitHub organization membership API on every request.

​
Multiple organizations

Each organization requires a separate installation. You can either:
  • Run npx mergewatch@latest init once per organization.
  • Install directly from your GitHub App settings page for additional organizations.
Each org installation is fully independent with its own configuration and review history.

​
Removing MergeWatch

To uninstall MergeWatch from your organization:
  1. Go to GitHub Settings > Applications > MergeWatch > Configure.
  2. Click Uninstall.
This removes the GitHub App installation but does not delete your cloud resources. See Uninstalling for full cleanup instructions.

​
Next steps

Permissions reference

Review the GitHub permissions MergeWatch requests and why each is needed.

Quickstart

Go from zero to your first AI-powered PR review in 10 minutes.