Starter
Try AI PR review.
- 2 reviewers
- Code Review
- Security Review
- 3 seats included
- 15,000 credits to start, then 5,000/mo
- About 70 reviews to start, then about 25 a month
- Unlimited repos
To require pull request reviews on GitHub, open the repository's Settings, click Branches and add a branch protection rule for main. Select Require a pull request before merging, then Require approvals, and set how many. Collaborators can then change main only through an approved pull request; admins are exempt until you select Do not allow bypassing the above settings.[1][2]
What lands on your pull request · Code Review
billing/checkout.ts:42 · A timed-out response can charge the order twice- await payments.charge(order);+ await payments.charge(order, {+ idempotencyKey: order.id,+ });
We build IonWarp, an AI reviewer for GitHub pull requests, so this guide also covers what most leave out: what an automated reviewer can and cannot satisfy. Our advice is to require one human approval, add the checks you trust and close the admin bypass. A required check can hold a merge; only a person can approve one.
On the repository's main page, click Settings, then Branches in the sidebar, then Add classic branch protection rule. You need admin access to the repository, or a custom role with the edit repository rules permission.[1][2]
Type main under Branch name pattern, or a pattern such as *release* to protect every branch with that word in its name. The branch does not have to exist yet.[1][2]
Select Require a pull request before merging, then Require approvals, and choose the number. Select Dismiss stale pull request approvals when new commits are pushed, so a commit added after the review does not ride on the old approval. If a CODEOWNERS file names who owns each path, select Require review from Code Owners too; the CODEOWNERS tester shows who GitHub would ask.[1]
Select Require status checks to pass before merging and search for each check by name. Pick a check that has already run on a pull request: when you set an expected source, GitHub offers an app that has recently set that check.[1][2]
By default a rule does not apply to people with admin permissions. Select Do not allow bypassing the above settings, then click Create. Force pushes and branch deletion are already blocked by the rule's defaults.[1][2]
Sign in with GitHub and install the IonWarp GitHub App on the organization or user, choosing the repositories. It gives IonWarp read-only code access and writes pull request comments and checks. Starter is free for 3 people with 15,000 credits to start; Pro is $49/mo for 5 seats. Open a pull request, let the review finish, then search for IonWarp / Review under the required checks.
Code ReviewOn Starter, Pro and Max
Protected branches and rulesets are available on public repositories with GitHub Free, and on public and private repositories with GitHub Pro, Team and Enterprise. A private repository on GitHub Free gets neither.[2][3]
An author cannot approve their own pull request,[4] so on a one-person repository a required approval can only be met through the admin bypass. Select Require a pull request before merging and leave Require approvals off: the two are separate options, so changes still go through a pull request and no second person is needed.[5]
A workflow skipped by path filtering or branch filtering leaves its check pending, and the pull request waits on Waiting for status to be reported. Do not require a workflow a filter can skip, and keep job names unique across workflows, because a repeated name can block merges too.[6][2]
GitHub calls the rule in these steps a classic rule, and rulesets set the same requirements under Settings, Rules, Rulesets, New branch ruleset. Several rulesets can apply to one branch and anyone with read access can see them; only one classic rule applies to a branch. Where both exist, every rule applies and the strictest version wins.[3][7]
IonWarp's review is one comment on the pull request, with the file, the line and a suggested fix, plus the check. It never submits an approval, so it cannot count toward Require approvals. The reading that does count is a person's: how to review a pull request walks through it.
IonWarp holds a merge only if you mark IonWarp / Review as required in GitHub; there is no separate IonWarp switch. Without a rule, every row below can merge. The P0, P1, P2 and did-not-run results are defaults you can change in IonWarp's Status Checks settings.
| Criterion | IonWarp | With the check required on GitHub |
|---|---|---|
| A P0 finding is open | Action required | Not a passing status, so the merge waits until a push fixes the finding or someone replies wontfix with a reason.[6] |
| Only P1 findings are open | Neutral | Counts as passing, so the pull request can merge.[6] |
| A clean review, or only P2 findings | Success | Passing, so the pull request can merge.[6] |
| A draft, a release pull request, or no reviewable diff | Skipped | Counts as passing, so it never holds a merge.[6] |
| The review could not run (it failed, credits ran out, or the project is paused) | Action required, or set Review did not run to Neutral | The merge waits. Comment @ionwarp review now to retry, or choose Neutral if a missed review should not hold a release.[6] |
One workspace price with seats included. Credits pool across your team. Unlimited repos on every plan.
Try AI PR review.
Get AI PR review right from day 1.
Scale AI PR review.
Custom reviewers + credits · GitHub Enterprise · SSO/SAML + audit logs · Custom security review + SLA
In the repository, open Settings, then Branches, and add a classic branch protection rule for your main branch. Select Require a pull request before merging, then Require approvals, choose the number of approvals, and click Create.
Add a branch protection rule with the pattern main. The rule blocks force pushes and deletion by default, Require a pull request before merging stops direct pushes, and Do not allow bypassing the above settings applies the rule to admins.
On GitHub Free, protected branches and rulesets are available on public repositories only. Private repositories need GitHub Pro, Team or Enterprise.
No. A pull request's author cannot approve it, so a required approval needs a second person with write access to the repository.
IonWarp cannot: its review is a comment and a check, never an approval, so a required approval still needs a person. You can require its check, IonWarp / Review, which by default holds the merge while a P0 finding is open.
Both can require reviews and checks. Several rulesets can apply to one branch and anyone with read access can see them, while only one classic rule applies to a branch. Where both exist, every rule applies and the strictest wins.