Skip to main content
BetaMulti-tenantSingle-tenant
Repository relationships define which repositories depend on each other. Qodo can discover them automatically, you can trigger discovery for a specific repository, or you can define them manually. Once defined, Qodo automatically uses them to detect breaking changes across repositories when a pull request (PR) is opened. This runs by default. See Disable Cross-repo context to turn it off.

​
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, status, and Created and Updated dates

​
Discover and add relationships

Qodo discovers relationships automatically for key repositories. You can also trigger discovery on demand for a specific repository, or add relationships yourself. These are displayed in the repository sidebar’s Cross repository relationships section or the Relationships table, and used the same way during review.
Relationships are non-directional. The order of Repository A and Repository B does not affect how the agent uses the relationship.

​
Automatic discovery across your organization

Qodo discovers relationships automatically, without any action from you. Any relationships found are displayed in the Cross repository relationships section. When discovery happens depends on which installation wizard connected your Git provider to Qodo:

​
Auto-discover relationships per repository

Trigger Qodo to scan a specific repository and find its related repositories.
  1. Go to the Repositories page and select the Repositories tab.
  2. Click the row of the repository you want to analyze to open its sidebar.
  3. In the Cross repository relationships section, click Auto-discover.
Qodo runs the discovery in the background and adds the relationships it finds. While discovery is running, the section shows a Discovering state, which usually takes a few minutes. You can keep working until it finishes.
Cross repository relationships section showing the empty state with an Auto-discover button and a confirmation that auto-discovery has started
Discovered relationships appear in the Cross repository relationships section as Qodo finds them, labeled Auto-discovered to distinguish them from relationships you added manually. If auto-discovery does not find any relationships, Qodo shows a No relationship found message.
Cross repository relationships panel listing discovered related repositories with their status
Only one discovery run can be active per repository at a time. If you start auto-discovery while a run is already in progress, Qodo shows that auto-discovery is already in progress for the repository.

​
Add relationships manually

You can also add relationships yourself from a repository’s sidebar.
  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 100 relationships.
  5. Click Add relationships.
Cross repository relationships panel in the sidebar with a repository picker, several repositories selected, and an Add relationships button

​
Keep relationship information current

Regardless of how a relationship was created, later activity keeps the information about the relationship current. You can see when that happened from its Updated date, and which pull request caused it from a link to that PR. See Relationships tab reference for the full list of fields shown for each relationship.

​
Relationship statuses

Whether a relationship is auto-discovered or added manually, Qodo processes it and shows one of the following statuses:
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.
When a PR triggers a review, Qodo analyzes the 10 active relationships most relevant to that PR.

​
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

Qodo doesn’t automatically remove a relationship once the dependency no longer applies, delete it manually to keep coverage accurate.
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.

​
Disable Cross-repo context

Cross-repo context is enabled by default. To turn it off: Navigate to Configurations > Context > Cross-repo context and disable the toggle. See Configure Qodo using the portal.

​
Disable using .pr_agent.toml

Default: true.

​
Next steps