PR Mode Extended+
An opt-in alternative to Codeveira's default post-commit review flow. Enable it per repository and a review opens the moment a pull/merge request (or, on Gerrit, a Change) opens, stays live as new commits or patch-sets land, and can merge or submit via the platform's own native endpoint once every required reviewer has approved.
Overview
By default, Codeveira reviews code after it lands on a branch — a webhook fires on push, Codeveira fetches the new commit and its diff, and creates a review. That flow never changes and keeps working even when PR mode is on.
PR mode adds a second, optional lifecycle on top: a review tied to the pull/merge request (or Gerrit Change) itself, from the moment it opens until it merges, closes, or is abandoned. It is available on all 8 supported platforms — GitLab, GitHub, Gitea, Forgejo, Bitbucket Cloud, Bitbucket Server, Azure DevOps, and Gerrit via its native patch-set/Change model — and requires an Extended license or higher.
How it works
- Opening a pull/merge request (or, on Gerrit, uploading the first patch-set of a Change) creates a review that stays open and live.
- Pushing new commits to the source branch (or uploading a new patch-set on Gerrit) syncs the review — a new commit is appended, and previously-approved reviewers are reset back to pending.
- Once every required reviewer has approved, a Merge (or, on Gerrit, Submit) button becomes available on the review.
- Comments, checklists, CI status, code coverage, SAST findings, and AI review all work identically to post-commit reviews — nothing about the review experience itself changes.
Enabling PR mode
Go to Repositories and open the repository (or tick it while filling in New Repository).
Tick Enable PR mode. It is off by default and only appears for repositories on a supported platform, with an Extended license or higher.
Enable the matching events on that repository's existing webhook on the platform side — see the table below. No new webhook URL is needed; the same endpoint already used for post-commit reviews carries PR mode events too.
Webhook events per platform
PR mode needs one additional event category ticked on the webhook you already configured for post-commit reviews. If a platform's box below isn't ticked, the pull/merge request or Change simply never opens a review — nothing else breaks.
| Platform | Event(s) to enable on the webhook |
|---|---|
| GitLab | Merge request events |
| GitHub | Pull requests |
| Gitea / Forgejo | Pull requests |
| Bitbucket Cloud / Server | Pull Request events |
| Azure DevOps | Pull request Service Hooks |
| Gerrit | patchset-created, change-merged, change-abandoned, change-restored (via the webhooks plugin — see the Gerrit integration guide) |
Merging / submitting
The Merge (or Submit) button on a PR-mode review does not perform a git-level merge inside Codeveira — it calls the platform's own native endpoint, so branch protection rules, required checks, and merge strategies configured on the platform itself are still respected:
- GitLab — the native "Accept MR" endpoint
- GitHub — the native "Merge PR" endpoint
- Gitea / Forgejo — the native pull-request merge endpoint
- Bitbucket Cloud / Server — the native PR merge endpoint
- Azure DevOps — the pull request completion API
- Gerrit — posts a
Code-Review: +2label, then calls Gerrit's ownsubmitendpoint
Runs alongside post-commit review
PR mode is additive, not a replacement. A repository with PR mode on still gets a post-commit review for any commit pushed directly to a tracked branch outside of a pull/merge request — for example a hotfix pushed straight to main. Codeveira also guards against double-reviewing the same commit: when a PR-mode review merges (or a Gerrit Change submits), the commit that lands on the target branch is not reviewed a second time by the post-commit path.
Troubleshooting
The "Enable PR mode" checkbox doesn't appear
Two possible causes: the current license is below Extended (check Settings → License), or the repository's source platform isn't one of the 8 supported ones.
A pull/merge request opened but no review appeared in Codeveira
The webhook is very likely missing the event category for this platform — see the table above. Check Settings → Webhook Deliveries to confirm whether the event even arrived; if it never arrived, it's a platform-side webhook configuration issue, not a Codeveira one.
New commits aren't syncing into an open PR-mode review
Same root cause as above — the sync relies on the same webhook event category as opening the review. Confirm it's still enabled and that recent deliveries succeeded in Settings → Webhook Deliveries.
The Merge/Submit button is missing or disabled
It only appears once every required reviewer has approved. On Gerrit specifically, submit can also be blocked by other Gerrit-side submit requirements (e.g. a required label Codeveira doesn't post) — check the Change directly in Gerrit for unmet requirements.
PR mode needs the same webhook already used for post-commit reviews — set that up first if you haven't.