GH-RELEASE-DELETE(1)

πŸ’… GH-RELEASE-DELETE(1) β€” the GitHub CLI manual, but make it make sense πŸŽ€

okay bestie, welcome to the gh manual page for gh-release-delete β€” it's the one where we yeet a release into the void. yes, this is a real page from the GitHub CLI manual. no cap. let's get into it ✨


🌸 NAME 🌸

gh-release-delete β€” Delete a release πŸ—‘οΈβœ¨

like literally, it deletes a release. that's the whole vibe.


πŸ¦‹ SYNOPSIS πŸ¦‹

gh release delete <tag> [flags]

so you hand it a <tag>, you can sprinkle some [flags] on top, and it goes to work. iconic behavior honestly.


πŸ’– OPTIONS πŸ’–

here's where it gets fun, pay attention:

  • --cleanup-tag β€” not just the release, bestie β€” this one ALSO deletes the tag the release was attached to. it's giving "take everything with me on the way out" πŸ’€
  • -y, --yes β€” skips that confirmation prompt. no "are you sure?" moment, no extra tap of the yes button. it just goes. use this when you're confident (or when you're in a script and there's nobody there to press yes 🫢)

✨ OPTIONS INHERITED FROM PARENT COMMANDS ✨

so these aren't even this command's own flags β€” they're handed down from the parent, like a cute little inheritance situation πŸ‘‘

  • -R, --repo <[HOST/]OWNER/REPO> β€” picks a whole different repo to work on, using the [HOST/]OWNER/REPO format. yes, with the optional host and all. don't skip the format, it matters πŸ’…

πŸ”₯ EXIT CODES πŸ”₯

every command has to tell you how it went, and here's the full rundown, no gatekeeping:

  • 0 β€” Successful execution πŸŽ‰ slay, it worked
  • 1 β€” Error 😭 something went wrong
  • 2 β€” Command canceled πŸ›‘ you (or something) backed out
  • 4 β€” Authentication required πŸ” you gotta prove who you are first, bestie
NOTE: specific commands may have additional exit codes, so pls refer to the command's help for more info. this list is not the whole story, iykyk 🧚

🌈 SEE ALSO 🌈

  • gh-release(1) β€” the main character of the release universe, go check it out πŸ‘‘

okay that's the whole page, you're caught up fr fr. this gorgeous little manual came from GitHub CLI v2.102.0, dated Oct 2026 β€” so go forth and delete responsibly, bestie πŸ«ΆπŸ’–πŸŽ€

πŸ“¦ where this page comes from