GH-PR-REVERT(1)

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

💅 gh-pr-revert 💅

okay so real talk, this is a page from the GitHub CLI manual — the gh-pr-revert one specifically — and honestly? it's giving "undo button but make it official." 🎀

✨ NAME ✨

gh-pr-revert — revert a pull request, bestie. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

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

so you point it at a pull request — by its number, by its url, or by its branch — and it does the reverting thing. pick one of those three, okay? the curly braces are literally telling you it's a "choose your fighter" situation. 🫶

💖 OPTIONS 💖

  • -b, --body <string> — the body text for the revert pull request. like, what do you wanna say in the description? put it here. ✍️
  • -F, --body-file <file> — read the body text from a file instead. and yes, you can pass "-" to read it from standard input — iconic behavior honestly. 🍓
  • -d, --draft — mark the revert pull request as a draft. not ready for the world yet, and that's valid. 🙈
  • -t, --title <string> — the title for the revert pull request. name your child. 👑

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • -R, --repo <[HOST/]OWNER/REPO> — select another repository using the [HOST/]OWNER/REPO format. yes that bracket situation is on purpose, copy it exactly, don't come for me. 💀

⭐ EXIT CODES ⭐

okay so when this thing finishes, it tells you how it went:

  • 0: Successful execution — slay, it worked. ✅
  • 1: Error — something went sideways. 😭
  • 2: Command canceled — you (or something) hit the brakes. 🛑
  • 4: Authentication required — you gotta prove who you are first, bestie. 🔐
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. (fr fr, check the help if you're getting a number that isn't in this list 👀)

🦋 SEE ALSO 🦋

  • gh-pr(1) — the parent command, go say hi.

and that's the page!! no cap, every flag is there, nothing skipped 💜

sign-off time: this whole thing is from GitHub CLI v2.102.0, dated Oct 2026 — so if you're reading this from the future, hi, hope your reverts all exit 0. 🌟🎀

📦 where this page comes from