gh-issue-list - Man Page

List issues in a repository

Synopsis

gh issue list [flags]

Description

List issues in a GitHub repository.

The search query syntax is documented here: https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requestshttps://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests

Options

--app <string>

Filter by GitHub App author

-a,  --assignee <string>

Filter by assignee

-A,  --author <string>

Filter by author

-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>

Maximum number of issues to fetch

--mention <string>

Filter by mention

-m,  --milestone <string>

Filter by milestone number or title

-S,  --search <query>

Search issues with query

-s,  --state <string>

Filter by state: {open|closed|all}

-t,  --template <string>

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

-w,  --web

List issues in the web browser

Options Inherited from Parent Commands

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

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

Example

$ gh issue list --label "bug" --label "help wanted"
$ gh issue list --author monalisa
$ gh issue list --assignee "@me"
$ gh issue list --milestone "The big 1.0"
$ gh issue list --search "error no:assignee sort:created-asc"

See Also

gh-issue(1)

Referenced By

gh-issue(1).

Aug 2023 GitHub CLI manual