Agent Upstart

Cool things people are building with agents — and practical help getting the most out of them.

Playbooks · Teams

Copilot Agent Merge: watch a PR and fix its blockers

Written November 13, 2026

Agent Merge watches a pull request and fixes what blocks it — failed checks or conflicts. The gates, the approval rule, and what it won't touch.

What changed

Agent Merge existed in the GitHub Copilot app and in Visual Studio Code first. On October 28, GitHub integrated it into pull requests on GitHub.com. Select Watch and fix in a pull request's merge box, and Copilot keeps watch over that pull request. When a blocker you selected appears, Copilot starts work in a cloud development environment to clear it. It is a standing watch rather than a one-off command: the point is that the failure at 4 p.m. gets attention without anyone re-asking.

A walkthrough of the button is not the hard part. The decision a team lead actually faces is whether the gates around it are set the way they think, and whether one nearby setting, Copilot's own approval, has quietly been given merge power. Those are the two cells this page is about.

The blockers it can fix

GitHub's Agent Merge documentation gives you exactly two kinds of blocker to hand over, chosen per pull request:

You can pick either one or both. When Copilot starts, an update appears in the Agent Merge section of the merge box and as a timeline event explaining why it started. Behind the scenes, the fixes run in a GitHub Actions-based development environment rather than a cloud sandbox, using the repository's own setup steps file, custom instructions, and agent skills. You can also turn Agent Merge on by default for pull requests you create, under Settings, Copilot, Cloud. To stop it on one pull request, click Unassign Copilot in the merge box. One cost note from the docs: the AI credits Agent Merge uses are charged to the person who enables it for the pull request, who is not necessarily the author.

The gates before it runs

The approval rule that matters

Agent Merge gets a pull request ready; it does not supply the approvals a branch rule demands. GitHub's docs are plain that it does not replace your review or the repository's merge requirements, and that human review of Copilot's fixes is still needed before merging. It also combines with auto-merge without enabling it: Agent Merge clears blockers, auto-merge merges once all required reviews and status checks pass, and turning on the first leaves the second exactly as it was.

The separate question is whether a Copilot approval itself can count toward those required approvals. That is a different feature, Copilot code review's auto-approval, and GitHub's configuration documentation shows it as an admin-set stack, off unless someone turns it on:

So the answer for a team lead is concrete: Agent Merge cannot approve anything. If Copilot approvals count in your repositories today, someone in the admin stack set that switch, and the file-path list is the dial that narrows where it applies. The wider decision is framed in Decide whether Copilot should approve PRs.

What it won't touch

The blockers Agent Merge can act on are the two you select: failed workflows and merge conflicts. Review comments are not in that list on GitHub.com today, so a pull request blocked on a reviewer's requested changes waits for a human or another tool, not for the watch. And because the fixes arrive as new commits from an agent, they deserve the same read as any other contributor's push, especially where a workflow fix could mean a weaker test rather than a repaired one.

Related playbooks

Sources

Back to: Teams playbooks hub · Also: Decide whether Copilot should approve PRs · Copilot's model-policy API is GA at four levels