> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whim.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Pull Requests

> Create and manage pull requests from task branches.

When an AI agent finishes its work, you'll typically open a pull request from the task branch. Whim automatically detects PRs created from task branches and links them to the corresponding task with real-time status tracking.

## Creating a pull request

### From the AI agent

The most common approach — include instructions like "open a PR when done" in your prompt. The agent uses `gh pr create` to open a pull request from the task branch.

### From GitHub

Create a PR manually in GitHub from the task branch (e.g., `whim-ww-42`). Whim detects it automatically via webhook.

<Info>
  Whim links PRs to tasks by matching the branch name. Any PR from a `whim-*` branch is automatically associated with the corresponding task.
</Info>

## Status tracking

Once a PR is linked, Whim tracks its state in real time:

| Status     | Meaning                        |
| ---------- | ------------------------------ |
| **Draft**  | PR is open but marked as draft |
| **Open**   | PR is ready for review         |
| **Merged** | PR has been merged             |
| **Closed** | PR was closed without merging  |

Updates are pushed to the UI automatically — no refresh needed.

## PR display

Linked PRs appear on the task in both list and detail views:

* A **status badge** shows the current state with a color-coded indicator
* Clicking the badge opens the PR on GitHub
* The PR number is displayed for quick reference

If a task has multiple PRs, Whim surfaces the most recently updated one.

## Review workflow

1. **Task completes** — the agent finishes and optionally opens a PR
2. **Review in GitHub** — your team reviews using GitHub's standard tools
3. **Track in Whim** — PR status flows back to the dashboard automatically
4. **Merge** — merge in GitHub; Whim updates the status to "merged"

<Tip>
  If a reviewer requests changes, fork the task or send a follow-up prompt — the agent pushes new commits to the same branch, updating the existing PR.
</Tip>

## Multiple PRs per task

A task can have more than one linked PR — for example, PRs to multiple repos in a monorepo, or a closed PR replaced by a new one from the same branch. Whim tracks all of them but surfaces the most recent in the UI.

<CardGroup cols={2}>
  <Card title="Branch Isolation" icon="code-branch" href="/git/branch-isolation">
    How every task gets its own isolated Git branch.
  </Card>
</CardGroup>