.pr_agent.toml file and can also be applied at the organization level in the Qodo portal. Learn more in Customize the code review experience.
Commands can be used directly in pull request comments to trigger actions such as running reviews, generating summaries, or asking questions about code changes.
The sections below describe the available configuration settings and PR commands you can use to tailor the Qodo review experience.
Repository configuration options
Configuration is managed in the.pr_agent.toml file.
Review output and visibility
| Setting | TOML section | Description | Values |
|---|---|---|---|
comments_location_policy | [review_agent] | Controls where findings are posted in the pull request. | summary – all findings appear in a single summary commentinline – findings are posted directly on relevant lines of codeboth – a summary comment is posted and findings are also added inline (default) |
inline_comments_severity_threshold | [review_agent] | Determines which severity levels generate inline comments. | 3 – High only (default)2 – High and Medium1 – all findings |
PR summary
| Setting | TOML section | Description | Values |
|---|---|---|---|
publish_mode | [qodo_describe_agent] | Controls where the PR summary is posted. | comment – posts the summary as a standalone comment, separate from the pull request description (default)pr_description – updates the PR body with User Description and AI Description headingsdynamic – posts a comment if the author already wrote a PR description, otherwise updates the PR body |
Findings display
Not supported on Bitbucket Data Center.
| Setting | TOML section | Description | Values |
|---|---|---|---|
finding_overflow_count | [review_agent_ux] | Controls how many findings are shown before the rest collapse behind “View all”. | 0 – all findings collapsed1, 3 (default), 5 – number of findings shown before “View all”-1 – all findings expanded (portal: “All”) |
resolved_overflow_count | [review_agent_ux] | Controls how many resolved findings are shown before collapsing. | 0, 1, 3 (default), 5, -1 (portal: “All”) |
use_images_and_animations | [review_agent_ux] | If set to true, shows Qodo’s loading and empty-state illustrations and animations in review comments. | true (default) / false |
show_context_used | [review_agent_ux] | If set to true, shows the “Context sources” section in the code review summary comment. | true (default) / false |
show_persistent_review_section | [review_agent_ux] | If set to true, shows the “Previous reviews” history section in the code review summary comment. | true (default) / false |
show_daily_tips | [review_agent_ux] | If set to true, shows the rotating “Tip of the day” section above the comment footer. | true (default) / false |
show_dividers | [review_agent_ux] | If set to true, shows divider lines between the parts of the review comment; when false, parts stay separated by a single blank line. | true (default) / false |
show_comment_footer | [review_agent_ux] | If set to true, shows the Qodo footer at the bottom of the review comment. | true (default) / false |
severity_terminology | [review_agent_ux] | The vocabulary used for the three severity tiers in the review comment. | high_medium_low (default) / critical_warning_informational / required_recommended_optional / p0_p1_p2 |
findings_label_coloring | [review_agent_ux] | How group badges look in the review comment. | simplified (default, Qodo brand) / color_scale / grayscale |
Expanded sections in findings
Not supported on Bitbucket Data Center.
| Setting | TOML section | Description | Values |
|---|---|---|---|
expand_description | [review_agent_ux] | If set to true, expands the description section by default. | true (default) / false |
expand_code | [review_agent_ux] | If set to true, expands the code section by default. | true (default) / false |
expand_recommendation | [review_agent_ux] | If set to true, expands the recommendation section by default. | true (default) / false |
expand_evidence | [review_agent_ux] | If set to true, expands the evidence section by default. | true / false (default) |
expand_prompt | [review_agent_ux] | If set to true, expands the agent prompt section by default. | true / false (default) |
Review workflow options
| Setting | TOML section | Description | Values |
|---|---|---|---|
pr_commands | Git provider section ([github_app], [gitlab], [bitbucket_app], [bitbucket_server], [azure_devops_server]) | Commands run automatically when a PR is opened or updated. | /agentic_describe, /agentic_review |
feedback_on_draft_pr | Git provider section ([github_app], [gitlab], [azure_devops_server]) | If set to true, also runs pr_commands when a PR is opened as a draft, instead of waiting until the PR is published. | true / false (default) |
handle_push_trigger | Git provider section ([github_app], [gitlab], [bitbucket_app], [bitbucket_server], [azure_devops_server]) | If set to true, re-runs configured commands when new commits are pushed to the pull request. | true / false (default) |
push_commands | Git provider section ([github_app], [gitlab], [bitbucket_app], [bitbucket_server], [azure_devops_server]) | Commands run automatically when new commits are pushed to the pull request. Requires handle_push_trigger = true. | /agentic_review |
persistent_comment_notification | [review_agent] | If set to true, posts a “Qodo updated to latest commit” message each time the persistent review comment is updated. | true (default) / false |
demand_self_review | [review_agent] | If set to true, a checkbox appears in the PR for the author to confirm they reviewed the findings. | true / false (default) |
approve_pr_on_self_review | [review_agent] | If set to true, adds Qodo as a reviewer after the author confirms self-review, allowing the PR to be merged. | true / false (default) |
enable_chat_in_code_suggestions | [pr_code_suggestions] | If set to true, enables Qodo to automatically recognize and respond to questions written in PR comments. | true (default) / false |
Custom review instructions
| Setting | TOML section | Description | Values |
|---|---|---|---|
issues_user_guidelines | [review_agent] | Extra instructions for the Issue finding agent, which handles bug, security, and performance detection. | string |
compliance_user_guidelines | [review_agent] | Extra instructions for the Compliance agent, which handles rule checking. | string |
smart_router_extra_instructions | [review_agent] | Extra instructions for the review effort agent, which decides how much review depth a pull request needs. | string |
CI feedback options
GitHub| Setting | TOML section | Description | Values |
|---|---|---|---|
enable_auto_checks_feedback | [checks] | If set to true, automatically provides feedback when a CI check fails on a pull request. | true (default) / false |
excluded_checks_list | [checks] | A list of CI checks to exclude from feedback. | ["check1", "check2"] |
persistent_comment | [checks] | If set to true, updates an existing CI feedback comment instead of posting a new one for each run. | true (default) / false |
enable_help_text | [checks] | If set to true, displays a help message when a user comments /checks on a pull request. | true (default) / false |
final_update_message | [checks] | If set to true, posts an additional message indicating the CI feedback was updated to the latest commit. | true (default) / false |
Ignore rules
| Configuration key | TOML section | Description | Values |
|---|---|---|---|
ignore_pr_title | [config] | Ignores PRs with matching title patterns. | regex list |
ignore_pr_source_branches | [config] | Ignores PRs from matching source branches. | regex list |
ignore_pr_target_branches | [config] | Ignores PRs to matching target branches. | regex list |
ignore_pr_labels | [config] | Ignores PRs with specific labels. | label list |
ignore_pr_authors | [config] | Ignores PRs opened by specific users. | regex list |
ignore_repositories | [config] | Excludes specific repositories from analysis. | regex list |
allow_only_specific_folders | [config] | Limits analysis to PRs that touch specific folders. | folder list |
ignore_languages_frameworks | [config] | Excludes generated files by language/framework. | framework list |
ignore_ticket_labels | [config] | Ignores linked tickets with specific labels. | label list |
Remediation
| Setting | TOML section | Description | Values |
|---|---|---|---|
enable_fixer_agent | [chat_agent] | If set to true, turns on the Remediation agent. | true / false (default) |
enable | [fixer_agent] | The flag the engine checks before running /fix. Computed automatically from enable_fixer_agent for portal-managed workspaces; must be set explicitly in a hand-written .pr_agent.toml. | true / false (default) |
enable_auto_fix | [fixer_agent] | If set to true, turns on Auto fix, automatically generating fixes for review findings. | true / false (default) |
action_level_threshold | [fixer_agent] | Minimum severity level the Remediation agent fixes. | 3 – Action required only (default)2 – Action required and Review recommended1 – all findings |
open_new_pr | [fixer_agent] | If set to true, delivers fixes in a separate pull request instead of pushing to the current branch. | true (default) / false |
close_fix_pr | [fixer_agent] | If set to true, closes the fix pull request once the fixing loop concludes. | true (default) / false |
enable_commitable_suggestions | [review_agent] | If set to true, auto-attaches committable suggestions to eligible inline findings. | true / false (default) |
Access control
| Setting | TOML section | Description | Values |
|---|---|---|---|
invite_only_mode | [config] | If set to true, only invited users receive Qodo’s review feedback on their pull requests. Other users are silently skipped. | true / false (default) |
PR commands
These commands can be invoked directly in pull request comments.| Command | Use | Description |
|---|---|---|
/agentic_review | Primary review workflow | Runs the main Qodo review experience, generating prioritized findings and suggested fixes. Accepts --review_agent.issues_user_guidelines, --review_agent.compliance_user_guidelines, and --review_agent.smart_router_extra_instructions as parameters. See Extra instructions. |
/agentic_describe | PR summarization | Generates a structured summary of the pull request. |
/ask | PR-specific questions | Answers questions about the pull request and its code changes. |
/config | Inspecting available settings | Shows supported configuration keys and default values. |
/generate_labels | PR categorization | Suggests pull request labels based on code changes. |
/checks | CI troubleshooting | Analyzes CI failures and surfaces useful debugging context. |