# qodo-ai/pr-agent architecture

> Architecture diagram of the GitHub repository qodo-ai/pr-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qodo-ai/pr-agent
- Repository: https://github.com/qodo-ai/pr-agent

## Overview

PR-Agent is an AI-powered pull-request assistant. Users invoke commands locally or through platform integrations; the agent dispatches a command to a tool, which gathers PR context, uses an AI backend, and publishes a result through a Git provider. The graph includes documented tool capabilities and shared processing layers. Some subsystem paths are directories because their detailed implementations were not sampled; relationships are limited to README statements and SOURCE INDEX references.

Main entry points: [`pr_agent/tools/pr_reviewer.py`](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_reviewer.py) (Review), [`pr_agent/tools/pr_code_suggestions.py`](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_code_suggestions.py) (Code suggestions), [`pr_agent/agent/pr_agent.py`](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/agent/pr_agent.py) (Command agent), [`pr_agent/tools/pr_description.py`](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_description.py) (PR description)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_cli["CLI<br/>[cli.py]"]
  node_platform_hooks["Platform hooks"]
end

subgraph group_workflow["Command workflow"]
  node_agent["Command agent<br/>[pr_agent.py]"]
  node_review["Review<br/>[pr_reviewer.py]"]
  node_description["PR description<br/>[pr_description.py]"]
  node_suggestions["Code suggestions"]
  node_other_tools["Other PR tools"]
end

subgraph group_processing["Review processing"]
  node_pr_context["PR context<br/>[pr_processing.py]"]
  node_repo_context["Repository context<br/>[repo_context.py]"]
  node_diff_processing["Diff processing"]
  node_prompt_budget["Prompt budgeting<br/>[token_budget.py]"]
end

subgraph group_integrations["External integrations"]
  node_git_provider["Provider interface<br/>[git_provider.py]"]
  node_platform_providers["Platform providers"]
  node_ai_handlers["AI handlers"]
end

node_developer(("Developer"))
node_llm_service(("LLM service"))
node_pull_request(("Pull request platform"))

node_developer -->|"runs command"| node_cli
node_developer -->|"invokes commands"| node_platform_hooks
node_platform_hooks -->|"dispatches requests"| node_agent
node_cli -->|"dispatches commands"| node_agent
node_agent -->|"dispatches"| node_review
node_agent -->|"dispatches"| node_description
node_agent -->|"dispatches"| node_suggestions
node_agent -->|"dispatches"| node_other_tools
node_review -->|"uses"| node_pr_context
node_description -->|"uses"| node_pr_context
node_suggestions -->|"uses"| node_pr_context
node_review -->|"uses"| node_repo_context
node_description -->|"uses"| node_repo_context
node_suggestions -->|"uses"| node_repo_context
node_review -->|"uses"| node_diff_processing
node_suggestions -->|"uses"| node_diff_processing
node_review -->|"uses"| node_prompt_budget
node_description -->|"uses"| node_prompt_budget
node_suggestions -->|"uses"| node_prompt_budget
node_review -->|"requests completion"| node_ai_handlers
node_description -->|"requests completion"| node_ai_handlers
node_suggestions -->|"requests completion"| node_ai_handlers
node_ai_handlers -.->|"sends prompts"| node_llm_service
node_agent -->|"gets provider"| node_git_provider
node_git_provider -->|"loads implementations"| node_platform_providers
node_review -->|"reads and publishes"| node_git_provider
node_description -->|"reads and publishes"| node_git_provider
node_suggestions -->|"reads and publishes"| node_git_provider
node_platform_providers -.->|"accesses PR platform"| node_pull_request

click node_cli "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/cli.py"
click node_platform_hooks "https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/servers"
click node_agent "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/agent/pr_agent.py"
click node_review "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_reviewer.py"
click node_description "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_description.py"
click node_suggestions "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_code_suggestions.py"
click node_other_tools "https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/tools"
click node_pr_context "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/pr_processing.py"
click node_repo_context "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/repo_context.py"
click node_diff_processing "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/git_patch_processing.py"
click node_prompt_budget "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/token_budget.py"
click node_git_provider "https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/git_providers/git_provider.py"
click node_platform_providers "https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/git_providers"
click node_ai_handlers "https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/algo/ai_handlers"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_platform_hooks toneBlue
class node_agent,node_review,node_description,node_suggestions,node_other_tools toneAmber
class node_pr_context,node_repo_context,node_diff_processing,node_prompt_budget,node_pull_request toneMint
class node_git_provider,node_platform_providers,node_ai_handlers toneRose
class node_developer,node_llm_service toneIndigo
```

## Components

### Entry points

- [CLI](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/cli.py): `pr_agent/cli.py`
- [Platform hooks](https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/servers): `pr_agent/servers`

### Command workflow

- [Command agent](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/agent/pr_agent.py): `pr_agent/agent/pr_agent.py`
- [Review](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_reviewer.py): `pr_agent/tools/pr_reviewer.py`
- [PR description](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_description.py): `pr_agent/tools/pr_description.py`
- [Code suggestions](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/tools/pr_code_suggestions.py): `pr_agent/tools/pr_code_suggestions.py`
- [Other PR tools](https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/tools): `pr_agent/tools`

### Review processing

- [PR context](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/pr_processing.py): `pr_agent/algo/pr_processing.py`
- [Repository context](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/repo_context.py): `pr_agent/algo/repo_context.py`
- [Diff processing](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/git_patch_processing.py): `pr_agent/algo/git_patch_processing.py`
- [Prompt budgeting](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/algo/token_budget.py): `pr_agent/algo/token_budget.py`

### External integrations

- [Provider interface](https://github.com/qodo-ai/pr-agent/blob/main/pr_agent/git_providers/git_provider.py): `pr_agent/git_providers/git_provider.py`
- [Platform providers](https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/git_providers): `pr_agent/git_providers`
- [AI handlers](https://github.com/qodo-ai/pr-agent/tree/main/pr_agent/algo/ai_handlers): `pr_agent/algo/ai_handlers`

### Other components

- **Developer**
- **LLM service**
- **Pull request platform**

## Connections

- Developer → CLI: runs command (evidence: `README.md`)
- Developer → Platform hooks: invokes commands (evidence: `README.md`)
- Platform hooks → Command agent: dispatches requests (evidence: `pr_agent/servers/gitlab_webhook.py`)
- CLI → Command agent: dispatches commands (evidence: `pr_agent/cli.py`)
- Command agent → Review: dispatches (evidence: `pr_agent/agent/pr_agent.py`)
- Command agent → PR description: dispatches (evidence: `pr_agent/agent/pr_agent.py`)
- Command agent → Code suggestions: dispatches (evidence: `pr_agent/agent/pr_agent.py`)
- Command agent → Other PR tools: dispatches (evidence: `pr_agent/agent/pr_agent.py`)
- Review → PR context: uses (evidence: `pr_agent/tools/pr_reviewer.py`)
- PR description → PR context: uses (evidence: `pr_agent/tools/pr_description.py`)
- Code suggestions → PR context: uses (evidence: `pr_agent/tools/pr_code_suggestions.py`)
- Review → Repository context: uses (evidence: `pr_agent/tools/pr_reviewer.py`)
- PR description → Repository context: uses (evidence: `pr_agent/tools/pr_description.py`)
- Code suggestions → Repository context: uses (evidence: `pr_agent/tools/pr_code_suggestions.py`)
- Review → Diff processing: uses (evidence: `pr_agent/tools/pr_reviewer.py`)
- Code suggestions → Diff processing: uses (evidence: `pr_agent/tools/pr_code_suggestions.py`)
- Review → Prompt budgeting: uses (evidence: `pr_agent/tools/pr_reviewer.py`)
- PR description → Prompt budgeting: uses (evidence: `pr_agent/tools/pr_description.py`)
- Code suggestions → Prompt budgeting: uses (evidence: `pr_agent/tools/pr_code_suggestions.py`)
- Review → AI handlers: requests completion (evidence: `pr_agent/tools/pr_reviewer.py`)
- PR description → AI handlers: requests completion (evidence: `pr_agent/tools/pr_description.py`)
- Code suggestions → AI handlers: requests completion (evidence: `pr_agent/tools/pr_code_suggestions.py`)
- AI handlers → LLM service: sends prompts
- Command agent → Provider interface: gets provider (evidence: `pr_agent/agent/pr_agent.py`)
- Provider interface → Platform providers: loads implementations (evidence: `pr_agent/git_providers/__init__.py`)
- Review → Provider interface: reads and publishes (evidence: `pr_agent/tools/pr_reviewer.py`)
- PR description → Provider interface: reads and publishes (evidence: `pr_agent/tools/pr_description.py`)
- Code suggestions → Provider interface: reads and publishes (evidence: `pr_agent/tools/pr_code_suggestions.py`)
- Platform providers → Pull request platform: accesses PR platform
