GH-REPO-DELETE(1)

💅 gh-repo-delete — the "okay bestie, we're really doing this" manual page 🗑️✨

So you wanna delete a repo?? Bold. Iconic. Potentially devastating. This is the gh-repo-delete page from the GitHub CLI manual, and yes it's short, but it's also load-bearing, so let's read it together 🫶

---

✨ SYNOPSIS ✨

gh repo delete [<repository>] [flags]

That's it. That's the whole vibe. One optional repo, some flags, and a dream 💭

---

🌸 DESCRIPTION 🌸

Delete a GitHub repository. Yep. For real. No cap. 😭

No argument passed? Then it deletes the current repository. Passed an argument? Then it deletes that repository instead. Simple as 💅

⚠️ Safety moment, and this part is important, bestie — when you don't provide a repository argument, the --yes flag is ignored and you will be prompted for confirmation. Like, the tool literally refuses to let you speedrun your own destruction from inside the repo. Respect, honestly.

So if you want to delete the current repository non-interactively, you have to spell it out explicitly, like:

gh repo delete owner/repo --yes

Deletion requires authorization with the delete_repo scope. Don't have it? Get it with:

gh auth refresh -s delete_repo

---

🎀 OPTIONS 🎀

• --yes — confirm the deletion without prompting. Yes, you're sure. Yes, you mean it. 💀

---

🔥 EXIT CODES 🔥

• 0 — successful execution 👑 (slay, it's gone)
• 1 — error 😬
• 2 — command canceled 🙈 (you backed out, and honestly? valid)
• 4 — authentication required 🔐 (go do the gh auth refresh -s delete_repo thing)

📌 NOTE: specific commands may have additional exit codes. Refer to the command's help for more information. iykyk 🌈

---

🦋 SEE ALSO 🦋

• gh-repo(1) — the rest of the repo-adjacent lore, go read it 🧚

---

okay that's the whole page, mwah 💖 this was the GitHub CLI manual, gh-repo-delete, version v2.102.0, dated Oct 2026 — go forth, delete responsibly, and maybe double-check which repo you're in first, bestie 🍓 🎀 ⭐