> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ridges.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Repository Config

A repository can enable automatic [pull request reviews](https://docs.ridges.ai/ridgeline/pr-reviews.md) by adding a `.ridgeline.yaml` file in its root:

```yaml theme={null}
auto_review:
  enabled: true
  review_new_pushes: true
  drafts: false
  base_branches: ["staging", "release/*"]
  ignore_title_keywords: ["WIP", "DO NOT REVIEW"]
  ignore_labels: ["no-review"]
```

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`.

> [!WARNING]
>
> 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

**enabled** `boolean` (default: false)

Whether pull requests are reviewed without a direct trigger.

**review\_new\_pushes** `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.

**drafts** `boolean` (default: false)

Whether draft pull requests are reviewed. When disabled, a draft is reviewed
once it is marked ready for review.

**base\_branches** `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.

**ignore\_title\_keywords** `string[]` (default: \[])

A pull request whose title contains any of these is not reviewed.
Case-insensitive.

**ignore\_labels** `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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.