GH-GIST-RENAME(1)

💅 GH-GIST-RENAME 💅

okay so bestie, welcome to the gh-gist-rename page — it's part of the GitHub CLI manual, and honestly? it's giving "tiny command, big slay". let's get into it 🎀

---

✨ NAME ✨

gh-gist-rename — rename a file in a gist 🦋

like, you have a gist, it has a file, and the filename? not it anymore. so we're gonna rename it. periodt.

---

🌸 SYNOPSIS 🌸

gh gist rename {<id> | <url>} <old-filename> <new-filename> [flags]

so you're passing in the gist — either by its <id> or by its <url>, pick your fighter 💅 — then the <old-filename> (the one that exists rn), then the <new-filename> (the glow-up), and optionally some [flags] if you're feeling extra.

---

👑 DESCRIPTION 👑

Rename a file in the given gist ID / URL.

that's literally it. that's the whole vibe. you give it a gist (by ID or URL), you tell it which file, and you tell it the new name. iconic behavior, no notes ✨

---

🧚 EXIT CODES 🧚

the receipts, aka what the command is telling you when it bounces 👇

• 0 — successful execution 💖 everything worked, we ate, no crumbs.
• 1 — error 😭 something went sideways.
• 2 — command canceled 🙈 you (or something) hit the brakes.
• 4 — authentication required 🔐 it needs you to be logged in, bestie.

NOTE: specific commands may have additional exit codes. refer to the command's help for more information. so like, don't come for me if you see a number that isn't on this list — check the command's own help, iykyk 🫶

---

💜 SEE ALSO 💜

• gh-gist(1) — the main character of the gist family 🌈 start here if you want the whole picture.

---

okay that's the page!! go rename something and make it cute 🌸🦋💫

—— and a lil sign-off from me to you: this absolute gem is from GitHub CLI v2.102.0, dated Oct 2026 🎀 mwah, go slay 💅