Gh Pr Merge

Merge GitHub pull requests using gh CLI with merge, squash, or rebase strategies and optional auto-merge.

dceoy 13aff02 1.1 KB Updated

File contents

GitHub PR Merge

When to use

  • The user asks to merge an approved PR.
  • You need to enable auto-merge.

Inputs to confirm

  • PR number/URL/branch (or use current branch PR).
  • Merge strategy: --merge, --squash, or --rebase.
  • Whether to delete the branch, use auto-merge, or use admin override.

Workflow

  1. Verify auth and PR status:
    gh --version
    gh auth status
    gh pr view 123
    
  2. Merge:
    gh pr merge 123 --squash
    gh pr merge 123 --merge --delete-branch
    
  3. Enable auto-merge if required checks are pending:
    gh pr merge 123 --auto --squash
    

Examples

# Squash merge and delete branch
~ gh pr merge 123 --squash --delete-branch

Notes

  • If a merge queue is required, gh pr merge will use it automatically.
  • Use --admin only when you have permission to bypass requirements.

References

dceoy/github-cli-agent-skills/tree/main/skills/gh-pr-merge commit 13aff026d6

Frequently asked questions

npx skillmds@latest add dceoy/gh-pr-merge