Code review
Review settings
Choose the reviewer model, what Codebot posts, and whether it approves or requests changes.
Review settings live on the Review tab of the Code review page. They apply to every repository you turned on. Only organization admins can change them.
Reviewer
The model that reviews your pull requests. Only models from providers with a key in Model providers are listed. If a provider’s key is removed, Codebot asks you to pick another model.
Instructions
Free-form instructions added to every review, for things that apply across all your repositories: what to focus on, what to ignore, the tone of comments. For rules about a single repository, use a .codebot/review.md file in that repository instead.
Focus on correctness and security. Don't comment on formatting; our linter handles it.
Flag any SQL built by string concatenation as high severity.Review outcome
What Codebot does with the pull request once the review is done:
| Option | Behavior |
|---|---|
| Comment only | Codebot leaves comments and never approves or blocks. |
| Approve when clean | Approves when there are no blocking issues; comments otherwise. |
| Request changes on blocking issues | Approves when clean and requests changes on critical or high-severity issues. |
A pull request with blocking issues still open from an earlier review is never approved, whichever option you pick.
Inline comments
The lowest severity Codebot comments on:
| Option | Posts |
|---|---|
| All findings | Everything, including minor suggestions and nits. |
| Medium and above | Skips nits and minor suggestions. |
| Blocking issues only | Only critical and high-severity bugs and security issues. |
Blocking issues are always posted.
Fail the check on blocking issues
Off by default. Turn it on to make Codebot’s check fail while blocking issues are open, so a branch protection rule can stop the merge. See Checks and merge gate.