gh-pr-merge

Merge current PR

$ gh pr merge

$ gh pr merge --squash

$ gh pr merge --rebase

$ gh pr merge --delete-branch

$ gh pr merge --auto

gh pr merge [pr-number] [options]

gh pr merge merges pull requests using GitHub's merge API. It supports all merge strategies: merge commits, squash merging, and rebasing. The command can wait for required checks and approvals.
Auto-merge enables setting a PR to merge automatically once all requirements are satisfied, useful for approved PRs waiting on CI. The delete-branch option cleans up after merging.
gh pr merge completes the pull request workflow from the command line.

PR-NUMBER

Pull request number (defaults to current branch).

Use merge commit (default).

Squash commits into one.

Rebase commits onto base branch.

Delete branch after merge.

Enable auto-merge when requirements met.

Merge with admin privileges.

Custom merge commit message.

Display help information.

Branch protection rules may prevent merging. Auto-merge requires repository feature enabled. Admin flag overrides protections.

gh pr merge is part of the GitHub CLI, implementing all merge strategies available through GitHub's web interface.

gh-pr(1), gh-pr-checks(1), git-merge(1)