Skip to content

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:

OptionBehavior
Comment onlyCodebot leaves comments and never approves or blocks.
Approve when cleanApproves when there are no blocking issues; comments otherwise.
Request changes on blocking issuesApproves 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:

OptionPosts
All findingsEverything, including minor suggestions and nits.
Medium and aboveSkips nits and minor suggestions.
Blocking issues onlyOnly 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.