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

# Configuration and command reference

> An overview of the commands and configuration options available in Qodo v2.

Qodo v2 is designed to work out of the box, with minimal setup required. Teams can start receiving useful pull request feedback immediately, while configuration options allow you to fine-tune how reviews behave and how feedback appears in your workflow.

Configuration settings are defined in the repository's [`.pr_agent.toml`](/code-review/get-started/configuration-overview/configuration-file) file and can also be applied at the organization level in the [Qodo portal](/code-review/get-started/configuration-overview/portal-configuration). Learn more in [Customize the code review experience](/code-review/get-started/configuration-overview).

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`](/code-review/get-started/configuration-overview/configuration-file) file.

### Review output and visibility

| Setting                                                                  | TOML section     | Description                                                | Values                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------ | ---------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`comments_location_policy`](/code-review/feedback-location)             | `[review_agent]` | Controls where findings are posted in the pull request.    | `summary` – all findings appear in a single summary comment<br />`inline` – findings are posted directly on relevant lines of code<br />`both` – a summary comment is posted and findings are also added inline (default) |
| [`inline_comments_severity_threshold`](/code-review/severity-thresholds) | `[review_agent]` | Determines which severity levels generate inline comments. | `3` – action required only (default)<br />`2` – action required and review recommended<br />`1` – all findings                                                                                                            |

### PR summary

| Setting                                   | TOML section            | Description                              | Values                                                                                                                                                                                                                                                                     |
| ----------------------------------------- | ----------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`publish_mode`](/code-review/pr-summary) | `[qodo_describe_agent]` | Controls where the PR summary is posted. | `comment` – posts the summary as a persistent comment (default)<br />`pr_description` – updates the PR body with User Description and AI Description headings<br />`dynamic` – posts a comment if the author already wrote a PR description, otherwise updates the PR body |

### Findings display

<Note>Not supported on Bitbucket Data Center.</Note>

| Setting                                                       | TOML section        | Description                                                                      | Values                                                                                                                                       |
| ------------------------------------------------------------- | ------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [`finding_overflow_count`](/code-review/findings-visibility)  | `[review_agent_ux]` | Controls how many findings are shown before the rest collapse behind "View all". | `none` – all findings collapsed<br />`1`, `3` (default), `5` – number of findings shown before "View all"<br />`all` – all findings expanded |
| [`resolved_overflow_count`](/code-review/findings-visibility) | `[review_agent_ux]` | Controls how many resolved findings are shown before collapsing.                 | `none`, `1`, `3` (default), `5`, `all`                                                                                                       |

### Expanded sections in findings

<Note>Not supported on Bitbucket Data Center.</Note>

| Setting                                                  | TOML section        | Description                                                    | Values                     |
| -------------------------------------------------------- | ------------------- | -------------------------------------------------------------- | -------------------------- |
| [`expand_description`](/code-review/findings-visibility) | `[review_agent_ux]` | If set to `true`, expands the description section by default.  | `true` (default) / `false` |
| [`expand_code`](/code-review/findings-visibility)        | `[review_agent_ux]` | If set to `true`, expands the code section by default.         | `true` (default) / `false` |
| [`expand_relevance`](/code-review/findings-visibility)   | `[review_agent_ux]` | If set to `true`, expands the relevance section by default.    | `true` / `false` (default) |
| [`expand_evidence`](/code-review/findings-visibility)    | `[review_agent_ux]` | If set to `true`, expands the evidence section by default.     | `true` / `false` (default) |
| [`expand_prompt`](/code-review/findings-visibility)      | `[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`](/code-review/pr-summary), [`/agentic_review`](/code-review/use-qodo-in-prs/code-review) |
| [`handle_push_trigger`](/code-review/persistent-review-comments)          | 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`](/code-review/persistent-review-comments)                | 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`](/code-review/use-qodo-in-prs/code-review)                                                 |
| [`demand_self_review`](/code-review/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`](/code-review/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`](/code-review/auto-detected-questions) | `[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`](/code-review/extra-instructions)     | `[review_agent]` | Extra instructions for the Issues Agent, which handles bug, security, and performance detection. | string |
| [`compliance_user_guidelines`](/code-review/extra-instructions) | `[review_agent]` | Extra instructions for the Compliance Agent, which handles rule checking.                        | string |

### CI feedback options

<Badge color="outline-provider" size="sm" shape="pill" icon="github">GitHub</Badge>

| Setting                                                                  | TOML section | Description                                                                                                | Values                     |
| ------------------------------------------------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------- | -------------------------- |
| [`enable_auto_checks_feedback`](/code-review/enable-ci-failure-feedback) | `[checks]`   | If set to `true`, automatically provides feedback when a CI check fails on a pull request.                 | `true` (default) / `false` |
| [`excluded_checks_list`](/code-review/enable-ci-failure-feedback)        | `[checks]`   | A list of CI checks to exclude from feedback.                                                              | `["check1", "check2"]`     |
| [`persistent_comment`](/code-review/enable-ci-failure-feedback)          | `[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`](/code-review/enable-ci-failure-feedback)            | `[checks]`   | If set to `true`, displays a help message when a user comments `/checks` on a pull request.                | `true` (default) / `false` |
| [`final_update_message`](/code-review/enable-ci-failure-feedback)        | `[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`](/code-review/ignore-content-from-analysis)             | `[config]`   | Ignores PRs with matching title patterns.           | regex list     |
| [`ignore_pr_source_branches`](/code-review/ignore-content-from-analysis)   | `[config]`   | Ignores PRs from matching source branches.          | regex list     |
| [`ignore_pr_target_branches`](/code-review/ignore-content-from-analysis)   | `[config]`   | Ignores PRs to matching target branches.            | regex list     |
| [`ignore_pr_labels`](/code-review/ignore-content-from-analysis)            | `[config]`   | Ignores PRs with specific labels.                   | label list     |
| [`ignore_pr_authors`](/code-review/ignore-content-from-analysis)           | `[config]`   | Ignores PRs opened by specific users.               | regex list     |
| [`ignore_repositories`](/code-review/ignore-content-from-analysis)         | `[config]`   | Excludes specific repositories from analysis.       | regex list     |
| [`allow_only_specific_folders`](/code-review/ignore-content-from-analysis) | `[config]`   | Limits analysis to PRs that touch specific folders. | folder list    |
| [`ignore_languages_frameworks`](/code-review/ignore-content-from-analysis) | `[config]`   | Excludes generated files by language/framework.     | framework list |
| [`ignore_ticket_labels`](/code-review/ignore-content-from-analysis)        | `[config]`   | Ignores linked tickets with specific labels.        | label list     |

## PR commands

These commands can be invoked directly in pull request comments.

| Command                                                                                  | Use                           | Description                                                                                                                                                                                                                                                          |
| ---------------------------------------------------------------------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`/agentic_review`](/code-review/use-qodo-in-prs/code-review)                            | Primary review workflow       | Runs the main Qodo review experience, generating prioritized findings and suggested fixes. Accepts `--review_agent.issues_user_guidelines` and `--review_agent.compliance_user_guidelines` as parameters. See [Extra instructions](/code-review/extra-instructions). |
| [`/agentic_describe`](/code-review/pr-summary)                                           | PR summarization              | Generates a structured summary of the pull request.                                                                                                                                                                                                                  |
| [`/ask`](/code-review/ask-questions-with-ask)                                            | PR-specific questions         | Answers questions about the pull request and its code changes.                                                                                                                                                                                                       |
| [`/config`](/code-review/get-started/configuration-overview/view-configuration-settings) | Inspecting available settings | Shows supported configuration keys and default values.                                                                                                                                                                                                               |
| [`/generate_labels`](/code-review/generate-pr-labels)                                    | PR categorization             | Suggests pull request labels based on code changes.                                                                                                                                                                                                                  |
| [`/checks`](/code-review/enable-ci-failure-feedback)                                     | CI troubleshooting            | Analyzes CI failures and surfaces useful debugging context.                                                                                                                                                                                                          |