Skip to content

Auto-Update PRs

The bot can bring open PRs up to date with their base branch — by merging or rebasing the new base into the PR head. This saves PR authors from manually updating branches every time someone else lands a change.

The feature is off by default and must be enabled per repo in the dashboard.


Open the repository’s settings page in the dashboard and find Auto-update PRs. Pick a Mode:

ModeBehavior
Off (default)Disabled — the bot does nothing.
AutomaticEvery push to the base branch triggers an update across all open PRs that target it.
ManualUpdates only run when triggered from the dashboard’s Pull Requests page. The bot does nothing on push.

When Mode is Automatic or Manual, two more settings appear:

Conflict handling

OptionBehavior
Only when cleanUpdates the PR if the merge or rebase is clean. On conflict, posts one comment asking for a manual update and stops. The coding agent is not invoked.
Resolve conflicts with agentUpdates the PR and runs the conflict-resolution loop on the coding agent if needed.

Strategy — pick Merge or Rebase as the update method.


Add the no-auto-update label to any PR you don’t want the bot to touch.


Regardless of mode, the bot skips:

  • Draft PRs
  • PRs from forks (the bot doesn’t have write access to fork head branches)
  • PRs the bot itself opened
  • PRs already up to date with the base branch
  • PRs labeled no-auto-update

Conflict handling and outcomeComment posted
Only when clean, clean updateNone.
Only when clean, conflict detected”I tried to auto-update … please update manually.”
Resolve conflicts with agent, any outcomeOne progress comment with steps and a final success or give-up summary.
PR skipped (draft, fork, up to date, etc.)None.