Skip to main content
BetaMulti-tenantSingle-tenant
Repository relationships define which repositories depend on each other. Once defined, Qodo automatically uses them to detect breaking changes across repositories when a pull request (PR) is opened. This runs by default; to view or change it, go to Configurations > General review and use the Cross-repo context toggle.

​
Prerequisites

  • Repositories must be installed using the Qodo installation wizard. Repositories installed using a previous method will not appear until reinstalled. See the migration guide for your Git provider.

​
Where to manage relationships

The Repositories page has two entry points for managing relationships:
  • Relationships tab: View and manage all relationships across your organization.
  • Repository sidebar: View and manage relationships scoped to a specific repository.
Repositories tab listing repositories with their installation, provider, repository status, Active relationships count, and code review toggle

​
View all relationships

  1. Go to the Repositories page and select the Relationships tab.
The tab shows all relationships defined across your organization. Toggle between List and Graph view using the controls at the top left. Use this view to audit relationship coverage across your organization.
Relationships tab in Graph view showing repositories connected by lines, with a Type filter for Code, Service, Data, Pipeline, and Other

​
View relationships for a specific repository

  1. Go to the Repositories page and select the Repositories tab.
  2. Click the row of the repository you want to inspect.
  3. The sidebar opens on the right. The Cross repository relationships section shows all relationships defined for that repository, including the linked repository, relationship type, description, and status.
Repository sidebar showing the Cross repository relationships section with linked repositories, their type, description, and status

​
Add a relationship

You can add a relationship from the Repositories tab by opening a repository’s sidebar.
Relationships are non-directional. The order of Repository A and Repository B does not affect how the agent uses the relationship.
  1. Go to the Repositories page and select the Repositories tab.
  2. Click the row of one of the repositories to open its sidebar.
  3. In the Cross repository relationships section, under Add related repositories, select the Select repositories to create a relationship field.
  4. Select the repositories to link. Each repository supports up to 10 relationships.
  5. Click Add relationships.
Cross repository relationships panel in the sidebar with a repository picker, several repositories selected, and an Add relationships button
After adding a relationship, Qodo begins processing it automatically. The relationship shows one of the following statuses:
StatusDescription
PendingQodo is analyzing the repositories and building the relationship context. This typically takes a few minutes.
ActiveThe relationship is confirmed and in use. Qodo checks this relationship on every relevant PR.
Not foundQodo could not determine a connection between the two repositories. You can add custom instructions to guide the analysis and retry. See Retry a relationship connection.
ErrorSomething went wrong during processing. Retry the relationship connection from the three-dot menu, or delete and recreate it.
For a description of each relationship type, see Cross-repository code review.
Once a relationship is active, Qodo checks it on every subsequent PR. By default, Qodo targets the main branch of each connected repository. To point the review at a different branch or pull request, include a link to that branch or PR (in the other repository) in your PR description, or in a ticket linked to the PR. Existing open PRs are not retroactively updated.

​
Retry a relationship connection

If a relationship shows Not found or Error, Qodo could not establish the connection on its own. You can provide additional context to guide the analysis and retry:
  1. Click the three-dot menu on the relationship.
  2. Select Retry with custom instructions.
  3. In the Retry with custom instructions dialog, describe the dependency between the two repositories. These instructions give the agent additional context to guide the relationship analysis.
  4. Click Retry.
Retry with custom instructions dialog with a text field for describing the dependency between the repositories and a Retry button
Qodo reprocesses the relationship using your instructions. If it establishes a connection, the status changes to Active.

​
Remove a relationship

Deleting a relationship means Qodo will no longer use it to trace impact between the two repositories. If you delete a relationship by mistake, you will need to recreate it from scratch.

​
From the Relationships tab

  1. Go to the Repositories page and select the Relationships tab.
  2. Click the three-dot menu on the relationship you want to remove.
  3. Select Delete relationship.
  4. In the confirmation dialog, click Delete relationship to confirm.

​
From the repository sidebar

  1. Go to the Repositories page and select the Repositories tab.
  2. Click the row of the relevant repository.
  3. In the sidebar, click the three-dot menu on the relationship you want to remove.
  4. Select Delete.
  5. Confirm the deletion.

​
Export relationship details

Each relationship has a markdown file that describes the dependency in detail. To download it, click the three-dot menu on any relationship and select Download markdown. Use this to review what Qodo has inferred about the relationship or to share it with your team.

​
Next steps