Scroll to navigation

GH-PR-MERGE(1) GitHub CLI manual GH-PR-MERGE(1)

NAME

gh-pr-merge - Merge a pull request

SYNOPSIS

gh pr merge [<number> | <url> | <branch>] [flags]

DESCRIPTION

Merge a pull request on GitHub.

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

When targeting a branch that requires a merge queue, no merge strategy is required. If required checks have not yet passed, AutoMerge will be enabled. If required checks have passed, the pull request will be added to the merge queue. To bypass a merge queue and merge directly, pass the '--admin' flag.

OPTIONS

--admin
Use administrator privileges to merge a pull request that does not meet requirements

-A, --author-email <text>
Email text for merge commit author

--auto
Automatically merge only after necessary requirements are met

-b, --body <text>
Body text for the merge commit

-F, --body-file <file>
Read body text from file (use "-" to read from standard input)

-d, --delete-branch
Delete the local and remote branch after merge

--disable-auto
Disable auto-merge for this pull request

--match-head-commit <SHA>
Commit SHA that the pull request head must match to allow merge

-m, --merge
Merge the commits with the base branch

-r, --rebase
Rebase the commits onto the base branch

-s, --squash
Squash the commits into one commit and merge it into the base branch

-t, --subject <text>
Subject text for the merge commit

OPTIONS INHERITED FROM PARENT COMMANDS

-R, --repo <[HOST/]OWNER/REPO>
Select another repository using the [HOST/]OWNER/REPO format

SEE ALSO

gh-pr(1)

Feb 2023