GH-LABEL-CREATE(1)

💅 gh-label-create — bestie's guide to making labels ✨

okay so this is the gh-label-create(1) page from the GitHub CLI manual, and honestly? it's giving "small command, big main character energy." let's get into it 🫶

---

🌸 SYNOPSIS 🌸

gh label create <name> [flags]

that's it. that's the whole vibe check. you give it a name, you sprinkle some flags, you slay 💅

---

✨ DESCRIPTION ✨

so here's the tea: gh label create makes a new label on GitHub. and if the label already exists? you can update it with --force, no cap 🔥

you must specify a name for the label — that part is non-negotiable bestie, it's the whole point. the description and color are optional. and if you don't give it a color? a random one gets chosen for you, which is honestly kind of iconic — surprise me energy 🎀

⚠️ heads up: the label color needs to be a 6 character hex value. like E99695. six characters, hex, periodt. 💀

---

🦋 OPTIONS 🦋

• -c, --color <string> — the color of the label 🌈
• -d, --description <string> — the description of the label, aka its little personality blurb ✏️
• -f, --force — if the label already exists, this updates its color and description instead of just being sad about it. very "we're doing a glow-up" of you 💖

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

• -R, --repo <[HOST/]OWNER/REPO> — pick a different repository using the [HOST/]OWNER/REPO format. yes, that exact format, don't freestyle it 🧚

---

🍓 EXIT CODES 🍓

• 0: Successful execution — we ate and left no crumbs ✨
• 1: Error — it's giving struggle 😭
• 2: Command canceled — you changed your mind, valid 💅
• 4: Authentication required — log in first bestie 🙈

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

---

⭐ EXAMPLE ⭐

here's literally the cutest little example, creating a bug label:

# Create new bug label
$ gh label create bug --description "Something isn't working" --color E99695

see how the description says "Something isn't working"? relatable. and E99695 is that soft pink-red hex, obsessed 🌸

---

🔥 SEE ALSO 🔥

• gh-label(1) — go read the parent, it's the blueprint 💜

---

lowkey the easiest command in the whole CLI and yet here we are, thriving. go forth and label your issues, bestie — you're gonna do amazing 🎀

---

that's a wrap! brought to you by GitHub CLI v2.102.0, dated Oct 2026 — mwah, catch you on the next manpage 💖✨