gh-pr-update-branch(1)

gh-pr-update-branch1

Update a pull request branch

Usage

gh pr update-branch [{<number> | <url> | <branch>}] [flags]

Overview

Update a pull request branch with latest changes of the base branch.

Without an argument, the pull request that belongs to the current branch is selected.

The default behavior is to update with a merge commit (i.e., merging the base branch into the PR's branch). To reconcile the changes with rebasing on top of the base branch, the --rebase option should be provided.

Options

--rebase

Update PR branch by rebasing on top of latest base branch

Options inherited from parent commands

-R, --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format

Exit status

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

Examples

$ gh pr update-branch 23
$ gh pr update-branch 23 --rebase
$ gh pr update-branch 23 --repo owner/repo

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.