GH-PR-CLOSE(1)

📦
version 2.102.0 · 13 versions
, in opensuse-leap 16.0

💅 gh-pr-close — bestie's guide to closing a PR

okay so real talk, this is the gh-pr-close page from the GitHub CLI manual (yes, the GH-PR-CLOSE(1) one, we're being fancy today ✨), and it's genuinely so simple it's giving "one job and she does it." You wanna close a pull request? Say less. 🫶

🌸 NAME 🌸

gh-pr-close — close a pull request. that's it. that's the whole vibe. 💖

✨ SYNOPSIS ✨

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

so you point it at a PR and it closes it. and look, you've got options for how you point at it, because we're not gonna make you memorize numbers like some kind of monster:

  • a <number> — the PR's number, iconic and direct 👑
  • a <url> — just paste the whole link, no thoughts needed 🦋
  • a <branch> — the branch name, for the girlies who think in branches

pick one, any one. then add your [flags] if you're feeling extra. 💅

🎀 OPTIONS 🎀

  • -c, --comment <string> — drop a closing comment on your way out. like leaving a little goodbye note but make it professional 😭 takes a <string>, obviously.
  • -d, --delete-branch — delete both the local and remote branch after the close. highkey the most satisfying flag on this whole page. clean up your mess, queen 🧹✨ (and yes, it's both — local and remote, no cap.)

💜 OPTIONS INHERITED FROM PARENT COMMANDS 💜

  • -R, --repo <[HOST/]OWNER/REPO> — pick a different repository using the [HOST/]OWNER/REPO format. so you can be like "not this one, that one" across the whole group chat 🌈

🔥 EXIT CODES 🔥

vibe check time, here's what the numbers mean when she comes back:

  1. 0 — Successful execution. slay. it worked. 🎉
  2. 1 — Error. something went sideways, rip 💀
  3. 2 — Command canceled. you (or something) hit the brakes 🙈
  4. 4 — Authentication required. she doesn't know you like that yet, log in 🔐
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. fr fr, check the command's own help if you're getting a number that's not on this list 👀

🦋 SEE ALSO 🦋

  • gh-pr(1) — the parent page, go say hi to the whole gh pr family, they miss you 💖

and that's the whole page bestie!! no notes, ate and left no crumbs. 🌸

okay and for the little sign-off the manpage insists on: this was GitHub CLI v2.102.0, dated Oct 2026 — so go forth and close those PRs, you gorgeous main character, and remember: delete the branch, it's the right thing to do 💅🎀

📦 where this page comes from