Skip to main content
Beta
Cross-repository conflicts are findings generated by Qodo’s cross-repository code review that flag a change in a pull request that would break a related repository.

​
How cross-repository conflicts are generated

Cross-repository conflicts are generated by Qodo’s cross-repository code review, which reviews pull requests in repositories that have a defined relationship with other repositories. When a pull request modifies a component covered by a relationship, such as a shared library, an API contract, or a database schema, the agent reads the related repositories and traces the impact in both directions. If a change would break a related repository, it reports a cross-repository conflict finding with a direct link to the affected lines in that repository. The review runs automatically on any pull request in a repository that has at least one active relationship.
By default, the review compares against the main branch of each related repository. If your change has a matching pull request or branch in the related repository, include the related pull request URL or branch name in your pull request description or a linked ticket so the conflict is evaluated against that code. Otherwise, Qodo may flag a conflict that a related, unmerged pull request already resolves. For more information, see Cross-repository code review.
For how relationships are defined and how cross-repository review works in depth, see Cross-repository code review.

​
Configure cross-repository conflicts

  1. Log in to the Qodo portal.
  2. Set up a relationship between repositories. See Manage cross-repository relationships.
  3. Navigate to Configurations > Finding types.
  4. Verify that Cross-repo impact is enabled.

​
View the cross-repository conflict in the findings

Cross-repository code review adds the following finding type to the review output: 🔗 Cross-repo conflict: A change in the pull request would break a related repository.
Qodo pull request comment showing a cross-repository conflict finding with a description and a link to the affected code in the related repository
Cross-repository conflicts appear alongside other review findings:
  • 🐞 Bugs
  • 📘 Rule violations
  • 📎 Requirement gaps
All findings are displayed in a unified review comment. Cross-repository conflicts also appear on the Findings page in the Qodo portal, tagged Cross-repo.

​
Cross-repository conflict details

Each cross-repository conflict finding includes:
  • Description: Explanation of the breaking change and which related repository is affected
  • Code reference: Link to the affected lines in the related repository
  • Evidence: The related repository code used to detect the conflict, including a link to each relationship behind the finding
  • Agent prompt: A suggested prompt to help resolve the issue
Relationship links are listed first in Evidence, one for each related repository involved in the conflict. Each link is labeled with the two repositories, such as web-client -> api-server. Click a relationship link to open that relationship in the Relationships tab. The tab opens in Table view with the relationship’s side panel open. From there, read the full relationship context, retry the analysis with custom instructions, download it as Markdown, or delete the relationship. For more information, see View cross-repository relationships. The same link appears in the finding’s Evidence section on the Findings page in the Qodo portal.
Access to the linked relationship follows your organization’s portal permissions. If your organization restricts Software Map or Relationships access, or the relationship was deleted, the portal shows a message that the relationship could not be loaded. Contact your organization admin for access.