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

# Pull requests

> Open, review, and merge GitHub PRs from inside ADE — with stacked PRs and auto-merge.

Every PR your agents open lands in ADE's **PRs** tab — the diff, CI checks, comments, and a merge button, without a GitHub browser tab. ADE keeps remote GitHub state warm through background polling while treating your local git state as the source of truth for merge and conflict simulation.

![ADE's PRs tab](https://mintcdn.com/ade-ac1c6011/Mghbi7-G0yTaUGxT/media/current/pull-requests.jpg?fit=max\&auto=format\&n=Mghbi7-G0yTaUGxT\&q=85\&s=eee2c1fe284388a5682a561751a9e991)

The PRs tab: every pull request in the repo with its CI and review state.

[ADE PR management walkthrough](https://www.youtube.com/embed/r3T8ePQyM6M)

PR management walkthrough on YouTube.

Watch the full walkthrough on [YouTube](https://youtu.be/r3T8ePQyM6M).

## Open a PR from a lane

Because every lane is its own branch, opening a PR is one step. Pick the lane, confirm the base branch, and ADE creates the PR — from the lane, from a chat, or straight from the PRs tab. The draft title and body are prefilled from the lane's commits and diff, and ADE returns both the GitHub URL and an ADE deep link so an agent can drop both into its closeout note.

> [!NOTE]
>
> Branch names are validated before submission, so an invalid git ref fails in ADE with a clear message instead of an opaque GitHub API error.

## Inspect the PR

The detail view splits a PR into focused tabs — **Overview**, **Files**, **CI / Checks**, and **Activity** — and each one loads on its own, so a slow comments fetch never holds up the checks or files.

The Overview renders as a **Timeline + Rails** layout: a central event timeline (commits, comments, reviews, label changes, merges, deployments), a left rail with the commit list and push-time checks, and a right rail with merge readiness, reviewers, labels, and participants.

You can reply to review threads, resolve them, react to comments, request reviewers, and submit your own review — approve, request changes, or comment — without leaving ADE.

The PRs tab lists every PR in the repository — including ones opened outside ADE — with filters for label, author, and assignee, CI badges, review indicators, and the linked lane's color, so a glance correlates a PR with the lane that produced it. Each PR's size is split into code, tests, and docs, so you can tell a large change from a large test suite.

## Merge it

When checks pass and reviews are in, merge from the readiness panel. Pick the method — **squash**, **merge**, or **rebase** — and land it.

> [card] Auto-merge
>
> Let the PR merge itself the moment it's green — useful for stacked work where each child waits on its parent.

> [card] Merge bypass
>
> When branch protection blocks a clean merge, opt in to retry with an admin merge. GitHub still decides whether the bypass is allowed.

> [card] Post-merge cleanup
>
> ADE deletes the branch, archives the lane if configured, refreshes the base, and rescans rebase needs — all best-effort, so cleanup never undoes a good merge.

## Stacked PRs

For a GitHub stack, each lane has its own PR targeting the branch below it. Use `ade prs stacks` to inspect the stack; rebase a lane when its compare base advances.

> [card] Dependency-ordered landing
>
> Land a whole stack in one action: ADE merges the root, then each downstream PR in order, auto-rebasing any descendant that drifted and stopping on the first failure.

Each lane in the stack works on its own branch.

## Conflict simulation

Before you hit Merge, ADE predicts whether the PR lands cleanly on its base by running `git merge-tree` locally — no actual merge required. A predicted conflict disables the merge button (unless you opt into bypass) and surfaces the conflicting files. When updating a PR branch hits conflicts, ADE puts a resolve prompt in the lane's chat.

> [!NOTE]
>
> ADE uses your GitHub authentication. If PR data is missing, check GitHub access in Settings.

> [card] [History](https://ade-app.dev/docs/tools/history.md)
>
> Inspect the commits, chats, and agent work behind a pull request.

> [card] [Conflicts](https://ade-app.dev/docs/tools/conflicts.md)
>
> Detection, simulation, and AI-assisted resolution across lanes and PRs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.