gh-discussion-list - Man Page

gh discussion list [flags]

List discussions in a GitHub repository. By default, only open discussions are shown.

--after <string>

Cursor for the next page of results

--answered

Filter by answered state

-A, --author <string>

Filter by author

-c, --category <string>

Filter by category name or slug

-q, --jq <expression>

Filter JSON output using a jq expression

--json <fields>

Output JSON with the specified fields

-l, --label <strings>

Filter by label

-L, --limit <int> (default 30)

Maximum number of discussions to fetch

--order <string> (default "desc")

Order of results: {asc|desc}

-R, --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format

-S, --search <query>

Search discussions with query

--sort <string> (default "updated")

Sort by field: {created|updated}

-s, --state <string> (default "open")

Filter by state: {open|closed|all}

-t, --template <string>

Format JSON output using a Go template; see "gh help formatting"

-w,  --web

List discussions in the web browser

gh discussion ls

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

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

# 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

gh-discussion(1)

gh-discussion(1).