GH-DISCUSSION-CREATE(1)

💬 gh-discussion-create — the GitHub CLI manual, bestie edition ✨

okay so real talk, this page is from the GitHub CLI manual, and it's all about gh-discussion-create — the lil command that spins up a brand new discussion. it's still in preview btw, so don't come for me if things shift 👀

---

✨ SYNOPSIS ✨

gh discussion create [flags]

like, that's it. that's the whole vibe. flags optional-ish (we'll get to that 👀).

---

🦋 DESCRIPTION 🦋

So gh discussion create makes a new GitHub Discussion in a repository. slay.

Here's the tea tho — there are two whole modes and you gotta pick your fighter:

• non-interactive mode 💅 — if you pass --title, --body (or --body-file), and --category, the discussion just gets created, no questions asked. iconic, efficient, main character behavior.
• interactive mode 🎀 — the second you leave any of those flags out, you get hit with interactive prompts — but only when you're connected to a terminal, iykyk.

fr fr: all three of those flags together = no prompts. miss even one = prompts (if you're in a terminal). no cap.

---

🌸 OPTIONS 🌸

• -b, --body <string> — the actual body text of your discussion. the words. the content. the moment 💖
• -F, --body-file <string> — read the body from a file instead. and yes bestie, "-" means read it from stdin 🫶
• -c, --category <string> — the category for the discussion, by name or by slug
• -l, --label <strings> — labels to slap on the discussion (plural, so you can stack 'em like stickers on a laptop ⭐)
• -R, --repo <[HOST/]OWNER/REPO> — point at a different repo using the [HOST/]OWNER/REPO format 🦋
• -t, --title <string> — the title of your discussion. make it good, make it clickbait-adjacent 👑

---

💀 EXIT CODES 💀

these are the numbers it throws at you when it's done (or not):

• 0 — successful execution 🎉 everything ate, no crumbs
• 1 — error 😭
• 2 — command canceled 🙈
• 4 — authentication required 🔐 (go log in bestie)

NOTE: specific commands may have additional exit codes. refer to the command's help for more information. i don't make the rules 💅

---

🔥 EXAMPLE 🔥

# Create interactively
$ gh discussion create

# Create non-interactively
$ gh discussion create --title "My question" --category "Q&A" --body "Details here"

see how the second one has all three? yeah. that's the non-interactive trifecta ✨ first one? just vibes and prompts 🌈

---

👑 SEE ALSO 👑

• gh-discussion(1) — the parent, the icon, the blueprint 🧚

---

k bye, go start a discussion, be brave, be iconic 💜

🎀 this has been the GitHub CLI manual — GitHub CLI v2.102.0, dated Oct 2026. drink water, read the docs, mwah 🫶