Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gitar.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Gitar can prevent a PR from being merged when its code review finds issues above a severity threshold you configure. It uses your platform’s native review mechanism — requesting changes on GitHub or unapproving on GitLab — so the block integrates with your existing branch protection rules.

​
How It Works

1

Code review completes

Gitar reviews the PR as usual, producing a verdict based on the findings.
2

Verdict is evaluated against the threshold

If the verdict meets or exceeds your configured blocking level, Gitar submits a blocking review on the PR.
3

Issues are resolved

As you push fixes and findings are resolved, Gitar re-evaluates the verdict. Once it drops below the threshold, Gitar dismisses its blocking review and the PR can merge.

​
Enabling Block Merge

  1. Navigate to Settings in the Gitar dashboard
  2. Open the Code Review section
  3. Enable Block merge based on code review
  4. Select your desired blocking level

​
Platform Behavior

Gitar submits a “request changes” review on the PR. If your branch protection rules require approving reviews or no outstanding change requests, this blocks the merge button.When the block is lifted, Gitar dismisses its review. Repository admins can also dismiss the blocking review manually through GitHub’s UI — Gitar respects this override and will not re-block for the current review cycle.
Gitar adds itself as a reviewer and withholds approval. If your approval rules require Gitar’s approval, the MR cannot merge until the block is lifted.When issues are resolved, Gitar approves the MR to unblock it.

​
Overriding a Block

If you need to merge despite unresolved findings, you have two options:
  • gitar unblock command — Comment gitar unblock on the PR to dismiss the blocking review and allow merging.
  • Platform override — Dismiss the blocking review directly through GitHub or GitLab’s native UI.