Configuration Parameters for Optibot — Reviews

The Reviews settings control automated code review functionality per repository. Access them from your Optibot dashboard at agents.getoptimal.ai → select a repository → Settings tab → Reviews section.

Auto Review on PR Creation

Setting: Auto review | Type: boolean | Default: Off

Controls whether Optibot automatically reviews pull/merge requests when they are created.

When to use: Turn on if you want immediate feedback on all pull requests when they are first opened. Turn off if you prefer to manually trigger reviews — you can always do this by typing Optibot can you review this in any PR or MR comment.

Auto Review on New Commits

Setting: Auto review on push | Type: boolean | Default: Off

Configures Optibot to automatically re-review a pull or merge request every time new commits are pushed.

When to use:

Ideal when you push multiple follow-up commits to address feedback
Ensures each update is automatically re-reviewed
Helps teams maintain high-quality, iterative review workflows

Auto Review After CI Workflow

Setting: Auto review after workflow | Type: boolean | Default: Off

Triggers a review only after a CI workflow completes rather than immediately on PR open. Useful if you want Optibot to review post-build, once you know the branch is in a stable state.

Automated PR Approvals

Setting: Allow approve | Type: boolean | Default: Off

Gives Optibot the ability to automatically approve pull/merge requests that pass its review criteria.

When to use:

For trusted contributors or automated dependency updates
When you have strict CI/CD checks and trust Optibot’s judgment
When you require multiple approvals to merge — Optibot’s approval can count as one

⚠️ Use carefully. This gives Optibot approval authority. Best combined with Excluded Labels or Excluded Users.

Recommended setup: Enable Auto Review, enable Allow Approve, and add excluded labels like needs-review and breaking-change.

Code Suggestions

Setting: Code suggestions | Type: boolean | Default: On

Allows Optibot to generate inline code suggestions and improvements during reviews. Suggestions appear as committable changes directly in the PR.

Turn off if you only want high-level feedback without specific code changes.

Skip Files

Setting: Skip files | Type: array of glob patterns | Default: Empty

Tells Optibot to skip reviewing certain files based on glob patterns. Optibot will not generate suggestions on matching files and will not read them during a review.

When to use:

Exclude auto-generated files, test files, or documentation
Skip files with legal requirements against AI-generated code

Pattern examples:

Skip test files and documentation:

*.test.js, *.test.ts, *.md, docs/**/*

Skip generated and configuration files:

*.generated.*, dist/**/*, build/**/*, *.config.js, package-lock.json

Skip vendor and third-party code:

vendor/**/*, node_modules/**/*, third_party/**/*

Glob pattern reference:

*.ext — files with that extension in the repo root only
**/*.ext — files with that extension in any directory (recursive)
dir/**/* — all files under a specific directory

Review Sensitivity

Setting: Sensitivity | Type: string — Low / Medium / High | Default: Medium

Controls how aggressively Optibot flags issues in your code.

Level	Behavior
Low	Only reports high-confidence, critical issues such as bugs and security vulnerabilities
Medium	Balances critical findings with important improvements. Recommended for most teams.
High	Reports everything, including minor issues and stylistic concerns

Excluded Labels

Setting: Excluded labels | Type: array of strings | Default: Empty

Prevents Optibot from reviewing PRs or MRs that carry any of the specified labels. Labels are case-sensitive.

Examples:

Skip WIP and draft PRs:

WIP, work-in-progress, draft

Emergency bypass:

hotfix, emergency, critical-fix

Excluded Users

Setting: Excluded users | Type: array of strings | Default: Empty

Prevents Optibot from reviewing PRs or MRs opened by specified usernames.

Examples:

Exclude dependency bots:

dependabot, renovate, renovate[bot]

Exclude CI/CD bots:

github-actions[bot], gitlab-ci, release-bot

Auto Review on Draft

Setting: Auto review on draft | Type: boolean | Default: Off

When turned on, Optibot will review pull or merge requests that are in draft state. By default, Optibot skips draft PRs and only reviews once the PR is marked “Ready to review”.

Suppress Repeated Issues

Setting: Suppress repeated issues | Type: boolean | Default: Off

When enabled, issues that were already raised in a previous review on the same PR are moved to a collapsible section instead of being posted again as new inline comments. Reduces noise on PRs with multiple review cycles.

Note: All settings are per-repository. Changes take effect immediately for new PRs and MRs — no commits or deployments required.