Skip to main content
PR Review automatically runs a coding agent on every pull request — no mention required. Set it up once per workspace and it fires on every new PR across your connected repositories.

​
Setup

  1. Go to Settings → PR Review
  2. Enable the global toggle
  3. Select which agent to use for reviews
  4. Enable or disable review per repository
By default, all connected repositories are enabled. You can toggle individual repos on or off from the same settings page.
Only workspace admins can configure PR Review settings.

​
Draft pull requests

Enable Skip draft pull requests in Settings → PR Review to hold off on reviewing a PR while it is still a draft. The review runs once the PR is marked ready for review. This is off by default, and it applies to GitHub and GitLab only — Bitbucket has no draft state.

​
CI check conclusion

By default, the agent’s verdict decides whether the PR Review CI check passes or fails. Turn off Fail CI check on agent determination in Settings → PR Review and the check reports success whatever the agent concludes, so the review verdict never blocks a merge.

​
Supported platforms

GitHub, GitLab, and Bitbucket.

​
Custom instructions

To tailor what the agent looks for, add a .blocks/review.md file to the repository. Blocks will use it as the review prompt for every PR in that repo.

​
Responding to review comments

If the agent leaves review comments, you can ask it to address them directly: @blocks address the review comments and update the PR The agent will push fixes to the same branch without opening a new PR.

​
Choosing an agent

Any configured coding agent can be used for PR Review. Claude Code is recommended for most teams — it handles multi-file context well and produces actionable inline comments.