GH-DISCUSSION-LIST(1)

💬 gh-discussion-list — the GitHub CLI manual page, but make it cute 🎀

okay so bestie, this is the manual page for gh-discussion-list, straight out of the GitHub CLI manual ✨. It's currently in preview, which is giving "we're still cooking, don't @ me" energy, but honestly it already slays. Sit down, grab a strawberry 🍓, and let's go.

---

🌸 NAME 🌸

gh-discussion-list — lists discussions in a repository 💅 (preview, bestie — it's new new)

---

✨ SYNOPSIS ✨

gh discussion list [flags]

that's it. that's the whole vibe. flags are optional but they're where the fun lives 🦋

---

💖 DESCRIPTION 💖

So like — this lists the discussions in a GitHub repository. And by default, only open discussions are shown. Not closed ones. Not all of them. Just the open ones, bestie. If you want the closed ones you gotta ask nicely with a flag, okay? 😭 Lowkey iconic default behavior, no cap.

---

👑 OPTIONS 👑

here's the whole flag family, every single one, no gatekeeping 🫶

• --after <string> — the cursor for the next page of results. it's giving "pagination but make it a string" ✨
• --answered — filter by answered state. yep, that's the whole thing 💀
• -A, --author <string> — filter by author. only discussions from that person, main character energy 👑
• -c, --category <string> — filter by category name or slug. either works, she's flexible 🌸
• -q, --jq <expression> — filter the JSON output using a jq expression. chef's kiss for the data girlies 🔥
• --json <fields> — output JSON with the specified fields. choose your own adventure ✨
• -l, --label <strings> — filter by label. plurals everywhere, we love to see it 🎀
• -L, --limit <int> (default 30) — maximum number of discussions to fetch. thirty. that's the default. respect it 💅
• --order <string> (default "desc") — order of results: {asc|desc}. descending by default, we're going down bestie 🦋
• -R, --repo <[HOST/]OWNER/REPO> — select another repository using the [HOST/]OWNER/REPO format. go visit someone else's repo, respectfully 🙈
• -S, --search <query> — search discussions with a query. detective mode 🔍
• --sort <string> (default "updated") — sort by field: {created|updated}. updated is the default, so fresh-to-death first ⭐
• -s, --state <string> (default "open") — filter by state: {open|closed|all}. defaults to open, remember? told you 😌
• -t, --template <string> — format JSON output using a Go template; see gh help formatting. fancy formatting era 🎀
• -w, --web — list discussions in the web browser. bye, going to the browser 🌈

---

🦋 ALIASES 🦋

gh discussion ls

yes, ls works too. because of course it does. iykyk 💜

---

🌟 JSON FIELDS 🌟

these are the fields you can request with --json, all of them, copy-paste ready:

answerChosenAt, answerChosenBy, answered, author, body, category,
closed, closedAt, createdAt, id, labels, locked, number, stateReason,
title, updatedAt, url

look at that lineup. answerChosenAt? stateReason? absolutely ate 🔥

---

💀 EXIT CODES 💀

• 0 — successful execution. slay 💅
• 1 — error. it's giving oops 😭
• 2 — command canceled. you changed your mind, that's valid 🫶
• 4 — authentication required. log in bestie, we can't get in like that 🙈

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 there's a 5 somewhere, check the command's own help fr fr 💖

---

🍓 EXAMPLE 🍓

real commands, real copy-paste energy, exactly as written:

# List open discussions
$ gh discussion list

# List discussions with a specific category
$ gh discussion list --category General

# List closed discussions by author
$ gh discussion list --state closed --author monalisa

# List all discussions (closed or open) by label
$ gh discussion list --state all --label bug,enhancement

# List answered Q&A discussions as JSON
$ gh discussion list --answered --json number,title,url

# List unanswered Q&A discussions as JSON
$ gh discussion list --answered=false --json number,title,url

the --answered=false one is so underrated btw. unanswered Q&A hunting era 🌸

---

🧚 SEE ALSO 🧚

• gh-discussion(1) — the parent command, go say hi 🫶

---

and that's the page!! you made it, bestie 🌈 this was GitHub CLI v2.102.0, dated Oct 2026 — mwah, love that for us, go list some discussions 💖✨🎀