Two-layer model
Repository access in MergeWatch works in two layers:GitHub App scope
Which repositories the GitHub App can access. Managed on GitHub under Settings > Applications > MergeWatch > Configure. This controls whether MergeWatch receives webhook events for a repo.
Summary strip
Above the card grid, a summary strip shows: X connected / Y active / Z paused These counts update in real time as you toggle repositories.Card states
Each repository is displayed as a card with one of three states:| State | Indicator | Meaning |
|---|---|---|
| Active | Green dot | Receiving webhooks and actively reviewing PRs |
| Paused | Gray dot | In GitHub App scope but reviews are disabled — webhooks are silently ignored |
| No reviews yet | Empty state | Active but no pull requests have been opened since installation |
Toggling a repo
Click the toggle on any repository card to switch between Active and Paused. The change updates the enabled state in DynamoDB immediately. The UI uses optimistic updates with automatic rollback if the API call fails.Configure on GitHub
The Configure on GitHub button opens the GitHub App installation settings page where you can add or remove repositories from the App’s scope. This controls the first layer — which repos MergeWatch can access at all.Only GitHub org admins can modify the App’s repository scope on GitHub. This is a GitHub-level permission, not a MergeWatch restriction.
.mergewatch.yml badge
Repository cards display a badge when a.mergewatch.yml configuration file is detected at the root of the repo’s default branch. The file is detected on the first pull request webhook after installation.
Click the badge to navigate to the .mergewatch.yml reference documentation.