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

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

### Using CI feedback in pull requests

#### **Manual usage**

Comment on the PR:

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

### Disabling the tool from running automatically

If you want to disable the tool from running automatically, add the following to the [configuration file](/code-review/get-started/configuration-overview/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](/code-review/get-started/configuration-overview/configuration-file).

| Configuration key             | Default value | Description                                                                                                                         |
| ----------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `enable_auto_checks_feedback` | `true`        | Automatically provides feedback when a CI check fails on a pull request.                                                            |
| `excluded_checks_list`        | `[]`          | 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`            | `true`        | Displays a help message when a user comments `/checks` on a pull request.                                                           |
| `final_update_message`        | `true`        | 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>
