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

# Manage repositories

> View and manage individual repositories, connection health, PR history indexing progress, and code review status.

The **Repositories** tab lists all repositories Qodo has access to, across all your installations and providers. Each repository belongs to a single installation.

<Frame>
  <img src="https://mintcdn.com/qodo/PQOul-4HCn01HCup/images/administration/repositories-repositories-tab.png?fit=max&auto=format&n=PQOul-4HCn01HCup&q=85&s=6e3efed3d8597bcf8d341fcd3ab06206" alt="Repositories tab showing repository name, installation, provider, active relationships, connection health, PR history indexing, and code review toggle for each repository" width="1763" height="892" data-path="images/administration/repositories-repositories-tab.png" />
</Frame>

| Field                    | Description                                                                                                                                                                                                                                 |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Repository**           | Repository name and path.                                                                                                                                                                                                                   |
| **Installation**         | The installation this repository belongs to.                                                                                                                                                                                                |
| **Provider**             | The Git provider for this repository.                                                                                                                                                                                                       |
| **Active relationships** | Number of active cross-repo relationships defined for this repository.                                                                                                                                                                      |
| **Connection health**    | The current connection health for this repository, shown as a status badge. Hover a badge for details on its status. See [Connection health](#connection-health) below.                                                                     |
| **PR history indexing**  | Indexing progress of the repository's merged pull request history, shown as a status badge. This history powers Rule Miner and Relevance. See [PR history indexing](#pr-history-indexing) below.                                            |
| **Code review**          | Toggle to enable or disable Qodo code review for this repository. When disabled, code review is turned off but indexing continues, keeping the repository available for [cross-repository code review](/governance/cross-repo-code-review). |

<Note>
  When a new installation is added, code review is disabled for all repositories by default. You control which repositories Qodo actively covers.
</Note>

Use the **Filters** menu to narrow repositories by installation or provider. Use the **Search** bar to find a repository by name.

## Connection health

The **Connection health** column shows the current connection health for each repository.

| Status       | Description                                              |
| ------------ | -------------------------------------------------------- |
| **Healthy**  | Events are flowing normally.                             |
| **Degraded** | Delivery is auto-retrying after recent failures.         |
| **Disabled** | Connection is off. Reconnect the installation.           |
| **Pending**  | Qodo is verifying the connection.                        |
| **Unknown**  | Connection health isn't available for this provider yet. |

<Note>
  A newly added repository under an already-healthy installation shows **Pending** until its own connection check completes, rather than inheriting the installation's status. This reflects the repository's own state instead of assuming it is healthy.
</Note>

## PR history indexing

Qodo indexes a repository's merged pull request history in the background to power learning features such as [Rule Miner](/governance/rule-enforcement/rule-miner) and [Relevance](/code-review/relevance). The **PR history indexing** column is the visibility into that process, showing whether history has finished indexing, is still catching up, or failed. See [Understanding PR history indexing](/core-concepts/pr-history) for how Qodo uses this history once indexed.

<Tip>
  Check this status to confirm a repository has enough indexed history for Rule Miner and Relevance to work. If a repository isn't producing results, see [Rule Miner or Relevance isn't producing results](/code-review/troubleshooting/rule-miner-or-relevance-not-producing-results).
</Tip>

| Status          | Description                                                                                                                                                          |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Not started** | No indexing run has happened yet for this repository.                                                                                                                |
| **Indexing**    | The initial indexing run is in progress, including any retry attempts.                                                                                               |
| **Active**      | At least one full indexing run has completed successfully. Indexed history is available.                                                                             |
| **Updating**    | An incremental indexing run (triggered by new merged pull requests) is in progress. Previously indexed history remains available.                                    |
| **Active\***    | Indexed history is available, but the most recent incremental run failed repeatedly. Contact [Qodo support](https://help.qodo.ai/hc/en-us/requests/new) for details. |
| **Failed**      | The initial indexing run failed after all retries. Contact [Qodo support](https://help.qodo.ai/hc/en-us/requests/new) for details.                                   |

## Manage code review in bulk

Enable or disable code review for multiple repositories at once from the **Repositories** tab.

<Steps>
  <Step title="Select repositories">
    Select the checkbox next to each repository, or select the checkbox in the table's top row to select every repository at once.

    <Frame>
      <img src="https://mintcdn.com/qodo/E8-rkROvvG4zFyxd/images/administration/repositories-bulk-actions-bar.png?fit=max&auto=format&n=E8-rkROvvG4zFyxd&q=85&s=12f9de3e45245496610eff0a868694ef" alt="Repositories tab with multiple rows selected, showing the bulk actions bar with Disable code review and Enable code review options" width="2434" height="156" data-path="images/administration/repositories-bulk-actions-bar.png" />
    </Frame>
  </Step>

  <Step title="Select an action">
    Select **Enable code review** or **Disable code review** from the bar that appears at the bottom of the table. The action applies immediately to every selected repository.
  </Step>
</Steps>

## Repository sidebar

Click any row to open the sidebar for that repository. The sidebar has three sections:

* **Overview:** Enable or disable code review for the repository, and open it directly in your Git provider.
* **PR history indexing:** Indexing detail for the repository's pull request history. See [PR history indexing detail](#pr-history-indexing-detail) below.
* **Cross repository relationships:** All relationships defined for that repository. See [Cross repository relationships](#cross-repository-relationships) below.

### PR history indexing detail

The repository sidebar's **PR history indexing** section shows:

| Field                 | Description                                                                                             |
| --------------------- | ------------------------------------------------------------------------------------------------------- |
| **Status**            | The current indexing status for this repository. See [PR history indexing](#pr-history-indexing) above. |
| **Last updated**      | When this repository's indexing status was last updated.                                                |
| **Pull requests**     | Number of merged pull requests indexed.                                                                 |
| **Findings learned**  | Number of things Rule Miner and Relevance have learned from the indexed pull request history.           |
| **History covered**   | Date range from the first to the most recently indexed merged pull request.                             |
| **What this unlocks** | Which learning features (Rule Miner, Relevance) have enough indexed history to run for this repository. |

<Note>
  When a repository's status is **Not started**, indexing starts automatically once the repository's first pull request is opened.
</Note>

### Cross repository relationships

For each relationship, you can see the linked repository, relationship type, description, and status.

To add or remove relationships, see [Manage cross-repository relationships](/governance/cross-repo-code-review/repository-relationships).

## Best practices

* **Check connection health regularly:** A repository showing an error means Qodo cannot review pull requests in it. Scanning the **Connection health** column as part of your operational review helps catch a broken connection before it causes gaps in coverage.
* **Use filters to audit coverage:** Filter by installation or provider to verify that all expected repositories are connected and have code review enabled. This is especially useful after adding a new installation.
* **Be deliberate about what you enable:** New installations default to code review disabled. Onboard repositories intentionally rather than activating Qodo everywhere at once, so you can track rollout and keep your connection inventory accurate. When code review is disabled, indexing continues so the repository remains available for cross-repo context.

## Next steps

* [Manage Git installations](/governance/repositories/installations): Add installations and resolve connection errors.
* [Audit cross-repository relationships](/governance/repositories/relationships): Audit cross-repository relationships across your organization.
* [Rule Miner](/governance/rule-enforcement/rule-miner): See how PR history indexing turns into rules.
* [Relevance](/code-review/relevance): See how PR history indexing helps prioritize findings.
