Skip to main content
Qodo reviews the full codebase, not just the diff, to generate a structured summary that gives reviewers meaningful context before they look at a single line of code. The summary captures the intent of the change, estimates how long the review will take, surfaces high-level suggestions, and diagrams the architecture where relevant.
Generated PR summary comment showing tags, the Walkthroughs section, and File Changes grouped by category

​
What the summary includes

Qodo tags each PR and estimates how long the review will take, so reviewers can prioritize and plan before opening a single file. Tags include: Bug fix, Tests, Enhancement, Documentation, and Configuration changes. The Walkthroughs section breaks down the change in detail:
  • Description: A plain-language breakdown of what changed and why.
  • Diagram: An architecture diagram showing the flow and connections introduced by the change.
  • High-Level Assessment: Suggestions and alternatives for the author and reviewer to consider before or during review.
On Bitbucket Data Center, Qodo needs to upload the diagram as a PNG image, which requires a user with write access to the repository. Without this, Qodo cannot attach the image and omits the diagram section silently, with no error shown in the pull request.To enable diagrams, create a bot user with REPO_WRITE permissions and add the following to your .secrets.toml:
[bitbucket_server]
USERNAME="<BOT USERNAME>"
PASSWORD="<BOT PASSWORD>"
Do not commit .secrets.toml to version control.Bitbucket Server instances earlier than April 2020 may already have the necessary permissions in place and may not require this step. For more information, see the Atlassian community discussion.
File Changes groups modified files by category for a cleaner overview of the change surface.

​
How to generate a PR summary

​
Manually

Comment on the pull request: /agentic_describe Qodo acknowledges the request and posts the generated summary directly in the pull request.

​
Automatically

Qodo generates a summary automatically when a pull request is opened or updated. To adjust this behavior, configure it using .pr_agent.toml. For details, see Configuration fundamentals.

​
Configure where the summary is posted

By default, Qodo posts the PR summary as a persistent comment and does not modify the pull request description. To change this, set publish_mode in the [qodo_describe_agent] section of your .pr_agent.toml: 
[qodo_describe_agent]
publish_mode = "comment"
ValueBehavior
comment (default)Posts the summary as a persistent comment.
pr_descriptionUpdates the pull request body, adding User Description and AI Description headings.
dynamicPosts a comment if the author already wrote a pull request description, otherwise updates the pull request body.

​
What’s next