Skip to content

chore: add .pr_agent.toml to configure Qodo reviews#10416

Merged
GiladShoham merged 1 commit into
masterfrom
chore/add-pr-agent-toml
Jun 10, 2026
Merged

chore: add .pr_agent.toml to configure Qodo reviews#10416
GiladShoham merged 1 commit into
masterfrom
chore/add-pr-agent-toml

Conversation

@GiladShoham

Copy link
Copy Markdown
Member

Adds .pr_agent.toml to enable Qodo agentic reviews on PRs.

  • On PR open: /agentic_describe + /agentic_review
  • On push: /agentic_review
  • Skips bot-authored PRs (dependabot, renovate, teambit-ci)

Copilot AI review requested due to automatic review settings June 10, 2026 18:30
@qodo-free-for-open-source-projects

qodo-free-for-open-source-projects Bot commented Jun 10, 2026

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (1) 📘 Rule violations (0)

Grey Divider


Informational

1. Automation not documented 🐞 Bug ⚙ Maintainability
Description
.pr_agent.toml enables automatic agentic review commands on PR open/push, but the repo’s
contributor PR guidance doesn’t mention this new automation, making it harder to troubleshoot or
intentionally disable when it misbehaves. This is a maintainability/operability gap rather than a
functional bug in the product code.
Code

.pr_agent.toml[R1-14]

+[github_app]
+# Commands run automatically when a PR is opened.
+pr_commands = [
+    "/agentic_describe",
+    "/agentic_review",
+]
+
+# Re-run commands when new commits are pushed to the PR.
+handle_push_trigger = true
+
+# Commands run automatically on push (requires handle_push_trigger = true).
+push_commands = [
+    "/agentic_review",
+]
Evidence
The new file explicitly enables auto-run commands on PR open and push, while the repo’s PR
contribution section and PR template do not mention any such automated review tooling, leaving the
behavior undisclosed in contributor guidance.

.pr_agent.toml[1-14]
CONTRIBUTING.md[101-105]
.github/PULL_REQUEST_TEMPLATE.md[1-5]

Agent prompt
The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

## Issue description
The repo now contains `.pr_agent.toml` that triggers automatic Qodo agentic commands on PR open and on push. However, contributor-facing PR process docs don’t mention this automation, which reduces discoverability and makes debugging/intentional disabling harder.

## Issue Context
- Automation is configured in `.pr_agent.toml`.
- The PR contribution instructions currently describe PR expectations but don’t mention automated agentic reviews.

## Fix Focus Areas
- CONTRIBUTING.md[101-105]
- .pr_agent.toml[1-14]

## Suggested change
Add a short note under the "## Pull Requests" section in `CONTRIBUTING.md` (or another prominent contributor doc) explaining:
- that Qodo reads `.pr_agent.toml`
- which commands run on PR open/push
- where to adjust/disable behavior (edit/remove commands in `.pr_agent.toml`)

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools


Grey Divider

Qodo Logo

@qodo-free-for-open-source-projects

Copy link
Copy Markdown

PR Summary by Qodo

Add Qodo PR Agent config to auto-run agentic describe/review
⚙️ Configuration changes 🕐 Less than 5 minutes

Grey Divider

Walkthroughs

Description
• Adds repository-level .pr_agent.toml to enable Qodo agentic PR automation.
• Runs /agentic_describe + /agentic_review on PR open; reruns review on pushes.
• Skips automated reviews for known bot-authored PRs (dependabot/renovate/teambit-ci).
Diagram
graph TD
  A["Pull request event"] --> B["Qodo GitHub App"] --> C[".pr_agent.toml"] --> D["/agentic_describe"] --> E["/agentic_review"]
  C --> F{"Author ignored?"}
  F -->|"Yes"| G["Skip automation"]
  F -->|"No"| D

  subgraph Legend
    direction LR
    _evt["Event"] ~~~ _svc["Service"] ~~~ _cfg["Config"] ~~~ _cmd["Command"] ~~~ _dec{"Decision"}
  end
Loading
High-Level Assessment

The following are alternative approaches to this PR:

1. GitHub Actions workflow for PR automation
  • ➕ Full control over when/how reviews run (paths, labels, branches, concurrency)
  • ➕ Runs without requiring the Qodo GitHub App installation
  • ➖ More YAML/maintenance overhead
  • ➖ You must manage auth/secrets and command invocation yourself
2. Only run on PR open (disable push trigger)
  • ➕ Reduces noise and CI-style churn on frequent pushes
  • ➕ Lower compute/agent usage
  • ➖ Review output can become stale after new commits unless manually rerun

Recommendation: Using .pr_agent.toml is the most direct/idiomatic approach when the Qodo GitHub App is already the chosen integration, and the added bot ignore list prevents low-signal automated reviews. Consider disabling push-triggered reviews only if the repo sees many incremental pushes per PR and the extra agent output becomes noisy.

Grey Divider

File Changes

Other (1)
.pr_agent.toml Configure Qodo commands, push trigger, and bot author ignore list +35/-0

Configure Qodo commands, push trigger, and bot author ignore list

• Introduces Qodo PR Agent configuration to run '/agentic_describe' and '/agentic_review' on PR open, and rerun '/agentic_review' on push. Adds an explicit ignore list for common bot authors and leaves optional title-based ignores commented for maintainers to opt into later.

.pr_agent.toml


Grey Divider

Qodo Logo

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds repository-level configuration for the Qodo PR-Agent GitHub app so agentic description/review commands run automatically on PR open and on new pushes, while skipping bot-authored PRs.

Changes:

  • Introduces .pr_agent.toml with default PR-open commands (/agentic_describe, /agentic_review).
  • Enables push-triggered re-reviews (handle_push_trigger = true) and configures /agentic_review on push.
  • Configures bot author ignore list (dependabot, renovate, teambit-ci) with an optional (commented) title-regex ignore list.

@GiladShoham GiladShoham enabled auto-merge (squash) June 10, 2026 18:32
@GiladShoham GiladShoham merged commit 59855b1 into master Jun 10, 2026
13 checks passed
@GiladShoham GiladShoham deleted the chore/add-pr-agent-toml branch June 10, 2026 19:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants