1GH-ISSUE-LIST(1)               GitHub CLI manual              GH-ISSUE-LIST(1)
2
3
4

NAME

6       gh-issue-list - List issues in a repository
7
8
9

SYNOPSIS

11       gh issue list [flags]
12
13
14

DESCRIPTION

16       List issues in a GitHub repository.
17
18
19       The      search      query      syntax      is     documented     here:
20       https://docs.github.com/en/search-github/searching-on-github/searching-
21       issues-and-pull-requests            ⟨https://docs.github.com/en/search-
22       github/searching-on-github/searching-issues-and-pull-requests⟩
23
24
25

OPTIONS

27       --app <string>
28              Filter by GitHub App author
29
30
31       -a, --assignee <string>
32              Filter by assignee
33
34
35       -A, --author <string>
36              Filter by author
37
38
39       -q, --jq <expression>
40              Filter JSON output using a jq expression
41
42
43       --json <fields>
44              Output JSON with the specified fields
45
46
47       -l, --label <strings>
48              Filter by label
49
50
51       -L, --limit <int>
52              Maximum number of issues to fetch
53
54
55       --mention <string>
56              Filter by mention
57
58
59       -m, --milestone <string>
60              Filter by milestone number or title
61
62
63       -S, --search <query>
64              Search issues with query
65
66
67       -s, --state <string>
68              Filter by state: {open|closed|all}
69
70
71       -t, --template <string>
72              Format JSON output using a Go template; see "gh help formatting"
73
74
75       -w, --web
76              List issues in the web browser
77
78
79

OPTIONS INHERITED FROM PARENT COMMANDS

81       -R, --repo <[HOST/]OWNER/REPO>
82              Select another repository using the [HOST/]OWNER/REPO format
83
84
85

EXAMPLE

87              $ gh issue list --label "bug" --label "help wanted"
88              $ gh issue list --author monalisa
89              $ gh issue list --assignee "@me"
90              $ gh issue list --milestone "The big 1.0"
91              $ gh issue list --search "error no:assignee sort:created-asc"
92
93
94
95
96

SEE ALSO

98       gh-issue(1)
99
100
101
102                                   Jan 2023                   GH-ISSUE-LIST(1)
Impressum