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.

PR mode is per repository, not global. Turning it on for one repository has no effect on any other repository, or on post-commit reviews for the same repository — both modes run concurrently.

How it works

Enabling PR mode

1

Go to Repositories and open the repository (or tick it while filling in New Repository).

2

Tick Enable PR mode. It is off by default and only appears for repositories on a supported platform, with an Extended license or higher.

3

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.

PlatformEvent(s) to enable on the webhook
GitLabMerge request events
GitHubPull requests
Gitea / ForgejoPull requests
Bitbucket Cloud / ServerPull Request events
Azure DevOpsPull request Service Hooks
Gerritpatchset-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:

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.

See plans & pricing → ← All docs