Skip to main content
A repository can enable automatic pull request reviews by adding a .ridgeline.yaml file in its root:
The file is read at the head commit of each pull request, so each branch can have its own review config. A missing, unreadable or invalid file leaves everything off — a typo never starts charging anyone — and keys it does not recognise are ignored. Opening or reopening a pull request, or marking it ready for review, triggers a review. Pushing new commits to an open pull request also triggers a review unless you disable review_new_pushes.
There are two switches and both have to be on. The file turns automatic reviews on for the repository; each author also has to turn them on for themselves in their Ridgeline settings, because the author pays for the review of their own pull request. A pull request whose author has not is skipped silently.

auto_review

boolean
default:"false"
Whether pull requests are reviewed without a direct trigger.
boolean
default:"true"
Whether Ridgeline reviews new commits pushed to an open pull request. When disabled, reviews are triggered only when a pull request is opened, reopened, or marked ready for review.
boolean
default:"false"
Whether draft pull requests are reviewed. When disabled, a draft is reviewed once it is marked ready for review.
string[]
default:"[]"
Additional base branches to review, alongside the repository’s default branch, which is always included. Accepts patterns; for example, release/* matches all release branches.
string[]
default:"[]"
A pull request whose title contains any of these is not reviewed. Case-insensitive.
string[]
default:"[]"
A pull request carrying any of these labels is not reviewed. Case-insensitive.

Never reviewed automatically

Regardless of a repository’s .ridgeline.yaml config, a pull request is skipped when:
  • it is not open;
  • it was opened by a bot, including Ridgeline’s own fix pull requests, to prevent review loops;
  • its author is not a Ridgeline user, or has not turned automatic reviews on for themselves;
  • its author cannot be billed for it, whether for want of write access on the repository, credits, or room under a monthly limit.