---
title: Pull Requests
description: How Copilot handles pull requests: linking, projects, reviewers, size, and AI description.
---

# Pull Request Management

When your workflow runs on **`pull_request`** events (e.g. opened, edited, labeled), Copilot performs a set of actions so that PRs stay linked to issues, projects, and team workflows. It can link the PR to the issue, add it to project boards, assign reviewers, apply size and priority labels, and optionally generate the PR description with AI.

<CardGroup cols={2}>
  <Card title="Workflow setup" icon="play" href="/pull-requests/workflow-setup">
    Enable the action for pull_request events and minimal workflow YAML.
  </Card>
  <Card title="Capabilities" icon="list" href="/pull-requests/capabilities">
    PR–issue linking, project linking, reviewers, size and priority, AI description, comments and images.
  </Card>
  <Card title="AI PR description" icon="file-text" href="/pull-requests/ai-description">
    How OpenCode fills your PR template from the issue and branch diff.
  </Card>
  <Card title="Configuration" icon="gear" href="/pull-requests/configuration">
    PR-specific inputs: project columns, reviewers, images, AI.
  </Card>
  <Card title="Examples" icon="file-code" href="/pull-requests/examples">
    Full workflow YAML and common configurations.
  </Card>
</CardGroup>

## Quick summary

| What happens | What Copilot does |
|--------------|-------------------|
| A **PR is opened or updated** | Links the PR to the issue (from branch name); adds the PR to configured projects and moves it to the right column; assigns reviewers; computes size and priority from diff and updates labels; optionally generates or updates the PR description with AI. |
| **Push** to the PR branch | Commit workflow runs; Bugbot can post findings as review comments and update/sync with the issue. You can ask the bot to fix findings from a comment. See [Bugbot](/bugbot). |

**Bugbot** (potential problems) runs on **push** or on demand; findings appear as **review comments** on the PR and as **comments on the linked issue**. For full details, see [Bugbot](/bugbot).

## Next steps

- **[Workflow setup](/pull-requests/workflow-setup)** — Trigger events and minimal workflow.
- **[Capabilities](/pull-requests/capabilities)** — Detailed description of each capability.
- **[AI PR description](/pull-requests/ai-description)** — Enable and configure AI-generated descriptions.