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

# Enable automatic CI failure feedback

> Configure Qodo to automatically surface structured CI failure analysis, including failed stages, test names, and error logs, directly inside pull requests.

<div style={{ display: "flex", alignItems: "center", gap: "6px" }}>
  <Badge color="outline-provider" size="sm" shape="pill" icon="github">GitHub</Badge>
</div>

Qodo provides automatic CI feedback when a pull request contains failed checks.

When a CI failure is detected, Qodo analyzes the results and surfaces structured, actionable information directly in the pull request to help you quickly understand and resolve the issue.

The CI feedback includes:

* **Failed stage**: The pipeline stage where the failure occurred

* **Failed test name**: The specific test or job that failed

* **Failure summary**: A concise explanation of what went wrong

* **Relevant error logs**: Extracted log output to aid debugging

This feedback helps reduce context switching by keeping CI failure analysis inside the pull request, where you are already working.

## Request CI feedback manually

Comment on the pull request:

```bash theme={null}
/checks "https://github.com/{repo_name}/actions/runs/{run_number}/job/{job_number}"
```

Where:

* `{repo_name}` is the name of the repository.

* `{run_number}` is the run number of the failed check.

* `{job_number}` is the job number of the failed check.

## Configure CI failure feedback in .pr\_agent.toml

### Turn off automatic feedback

To stop the tool from running automatically, add the following to the [configuration file](/configuration/configuration-file):

```js theme={null}
[checks]
enable_auto_checks_feedback = false 
```

### Configuration options

Configure the `checks` tool by setting configurations under the `checks` part in your [configuration file](/configuration/configuration-file).

| Configuration key | Default value | Description |
| - | - | - |
| `enable_auto_checks_feedback` | `false` | Automatically provides feedback when a CI check fails on a pull request. |
| `excluded_checks_list` | `["lint"]` | A list of CI checks to exclude from feedback (for example: `["check1", "check2"]`). |
| `persistent_comment` | `true` | Updates an existing CI feedback comment instead of posting a new one for each run. |
| `enable_help_text` | `false` | Displays a help message when a user comments `/checks` on a pull request. |
| `final_update_message` | `false` | When `persistent_comment` is enabled, posts an additional message indicating that the CI feedback was updated to the latest commit. |

Example:

<Columns cols={2}>
  <Frame>
    <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/ci-failure-feedback-failed-check-pr-comment.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=a8a75374ee02c8ab4c3f6988cd1798ae" alt="PR comment showing a failed CI check with details from Qodo" width="1882" height="438" data-path="images/code-review/ci-failure-feedback-failed-check-pr-comment.png" />
  </Frame>

  <Frame>
    <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/ci-failure-feedback-failed-check-details.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=751f66a1588fee86df4cce0cbf3f392c" alt="Expanded CI check failure details shown in a pull request comment" width="1832" height="712" data-path="images/code-review/ci-failure-feedback-failed-check-details.png" />
  </Frame>
</Columns>

<Frame>
  <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/ci-failure-feedback-example-output.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=cb2d64de46289e4d06846890d070ac90" alt="Example output of CI failure feedback displayed as a Qodo comment on a pull request" width="1200" height="466" data-path="images/code-review/ci-failure-feedback-example-output.png" />
</Frame>

## Related resources

* [Trigger a code review](/code-review/use-qodo-in-prs): Run reviews automatically or manually.
* [Configure Qodo using the .pr\_agent.toml file](/configuration/configuration-file): Set up and manage repository-level configuration.


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