GH-REPO-RENAME(1)

💅 gh-repo-rename (1) — the GitHub CLI manual, bestie edition

okay so real talk, this is gh-repo-rename from the GitHub CLI manual, and it's literally the glow-up command for your repo's name. ✨

---

🌸 NAME 🌸

gh-repo-rename — rename a repository. that's it. that's the whole vibe. 💖

---

🎀 SYNOPSIS 🎀

gh repo rename [<new-name>] [flags]

---

🦋 DESCRIPTION 🦋

So like, you know when your repo has a name that's giving absolutely nothing and you just need a rebrand? same bestie. This command renames a GitHub repository. iconic behavior honestly.

Now, <new-name>? that's the name you want, and here's the tea — it's without the owner. so don't be out here typing the whole owner/name situation, just the name part, okay? 🫶

By default, the command renames the current repository — like, the one you're standing in, main character energy. Otherwise, the repository you specified with --repo gets renamed instead. you're in control, periodt. 👑

⚠️ okay important one: to transfer repository ownership to another user account or organization, you must follow additional steps on github.com. this command is not gonna do that for you, no cap. 🙈

for more info on transferring repository ownership, see:

⟨https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository⟩

---

✨ OPTIONS ✨

• -R, --repo <[HOST/]OWNER/REPO> — pick a different repository using the [HOST/]OWNER/REPO format. like, "not this one, that one" 💅
• -y, --yes — skip the confirmation prompt. living dangerously, skipping the "are you sure" moment, we love a decisive queen 🎀

---

💀 EXIT CODES 💀

know these by heart, bestie, iykyk:

• 0 — successful execution 🌈 slay
• 1 — error 😭
• 2 — command canceled 🫠
• 4 — authentication required 🔐 (go log in babes)

NOTE: specific commands may have additional exit codes. refer to the command's help for more information. 👀

---

🔥 EXAMPLE 🔥

# Rename the current repository (foo/bar -> foo/baz)
$ gh repo rename baz

# Rename the specified repository (qux/quux -> qux/baz)
$ gh repo rename -R qux/quux baz

see? foo/bar → foo/baz, and qux/quux → qux/baz. little rebrands, big impact. ✨

---

👑 SEE ALSO 👑

• gh-repo(1) — go read that one too, it's the whole family 🧚

---

kisses and commits, bestie — this page came to you from GitHub CLI v2.102.0, dated Oct 2026. you're welcome 💖✨🎀