Decide where your settings live
CodeRabbit serves everyone from one-person startups to enterprises with hundreds of thousands of repositories, so settings can live in many places. For most teams the answer is simple: a.coderabbit.yaml file in the repository. Use the web app if you prefer a UI, and reach for central configuration, global overrides and the other places only when you manage many repositories.
You can configure CodeRabbit in the web app or in a .coderabbit.yaml file in the repository. Decide first, because the two donât add up.
A file also makes it easy to experiment. Push two branches with the same code changes but different
.coderabbit.yaml settings, open a pull request from each, and compare the reviews. Itâs a good way to learn how CodeRabbit responds to settings. This works with the default Configuration source when both branches are in the same repository and youâre a trusted author there, because CodeRabbit then reviews each pull request with the file on its own branch.
To move web app settings into a file later, comment @coderabbitai generate configuration on a pull request. CodeRabbit opens a pull request that adds .coderabbit.yaml with your current settings. For every other place settings can live, see Compare every place settings can live.
For advanced setups,
.coderabbit.config.ts lets you compute settings in TypeScript, for example by base branch or changed paths, or by composing shared fragments. CodeRabbit uses it only when the repository has no YAML file. See TypeScript configuration.Set how strict reviews are
The review profile decides which findings become inline comments.chill is the default. Use assertive for every finding, including trivial ones, or quiet for critical and major findings only.
- In the app
- YAML
Go to Reviews > General and choose Profile.
Teach CodeRabbit your rules
Path instructions are the biggest step from generic reviews to reviews that know your product. Each one pairs a glob pattern with what to check in matching files. Concrete rules work better than general advice.- In the app
- YAML
Go to Reviews > General and add entries under Path instructions.
Skip files that donât need review
CodeRabbit already skips lock files, build output, generated code and binary files. Add your own exclusions, such as third-party code invendor or test fixtures.
- In the app
- YAML
Go to Reviews > General and add patterns under Path filters.
Choose which pull requests get reviewed
By default, CodeRabbit reviews every pull request that targets the default branch, except drafts. Add branches such as release branches, or turn on draft reviews.- In the app
- YAML
Go to Reviews > Auto review.
base_branches entry is a regular expression, added to the default branch. Use ^ and $ for an exact match.
Each push to a pull request that CodeRabbit already reviewed starts another review, and each review counts toward your rate limits. If you hit them often, tune incremental reviews under
reviews.auto_review. Lower auto_pause_after_reviewed_commits (default 5) so automatic reviews pause sooner, or set auto_incremental_review to false so only the first push is reviewed automatically. Comment @coderabbitai review whenever you want another review.Reuse the rules you already wrote
If your repository has guideline files for coding agents, such asAGENTS.md, CLAUDE.md or .cursorrules, CodeRabbit already uses them as review criteria. Thereâs nothing to set. Each file applies to its own directory and everything below it.
More: Code guidelines.
The whole file
With all four settings, a.coderabbit.yaml looks like this. The first line gives editors autocomplete and validation.
.coderabbit.yaml
Check that it worked
Comment@coderabbitai configuration on a pull request. CodeRabbit replies with the configuration the review uses. Each value has a # Source: comment that names where it came from, such as Repository YAML or defaults.
With the default Configuration source, when a repository member adds the file in a pull request from a branch in the same repository, that pull request is already reviewed with it. Otherwise it applies after it merges. See Check which configuration a review used.
Whatâs next
Write review instructions that work
Turn your teamâs rules into instructions CodeRabbit follows.
Reduce review noise
Cut comments your team doesnât act on.
Apply settings to every repository
Share one baseline across your organization.