gh-search-issues(1)

1GH-SEARCH-ISSUES(1)            GitHub CLI manual           GH-SEARCH-ISSUES(1)
2
3
4

NAME

6       gh-search-issues - Search for issues
7
8
9

SYNOPSIS

11       gh search issues [<query>] [flags]
12
13
14

DESCRIPTION

16       Search for issues on GitHub.
17
18
19       The  command supports constructing queries using the GitHub search syn‐
20       tax, using the parameter and qualifier flags, or a combination  of  the
21       two.
22
23
24       GitHub  search syntax is documented at: https://docs.github.com/search-
25       github/searching-on-github/searching-issues-and-pull-requests
26       ⟨https://docs.github.com/search-github/searching-on-github/searching-
27       issues-and-pull-requests⟩
28
29
30

OPTIONS

32       --app <string>
33              Filter by GitHub App author
34
35
36       --archived
37              Restrict search to archived repositories
38
39
40       --assignee <string>
41              Filter by assignee
42
43
44       --author <string>
45              Filter by author
46
47
48       --closed <date>
49              Filter on closed at date
50
51
52       --commenter <user>
53              Filter based on comments by user
54
55
56       --comments <number>
57              Filter on number of comments
58
59
60       --created <date>
61              Filter based on created at date
62
63
64       --include-prs
65              Include pull requests in results
66
67
68       --interactions <number>
69              Filter on number of reactions and comments
70
71
72       --involves <user>
73              Filter based on involvement of user
74
75
76       -q, --jq <expression>
77              Filter JSON output using a jq expression
78
79
80       --json <fields>
81              Output JSON with the specified fields
82
83
84       --label <strings>
85              Filter on label
86
87
88       --language <string>
89              Filter based on the coding language
90
91
92       -L, --limit <int>
93              Maximum number of results to fetch
94
95
96       --locked
97              Filter on locked conversation status
98
99
100       --match <strings>
101              Restrict search to specific  field  of  issue:  {title|body|com‐
102              ments}
103
104
105       --mentions <user>
106              Filter based on user mentions
107
108
109       --milestone <title>
110              Filter by milestone title
111
112
113       --no-assignee
114              Filter on missing assignee
115
116
117       --no-label
118              Filter on missing label
119
120
121       --no-milestone
122              Filter on missing milestone
123
124
125       --no-project
126              Filter on missing project
127
128
129       --order <string>
130              Order of results returned, ignored unless '--sort' flag is spec‐
131              ified: {asc|desc}
132
133
134       --owner <string>
135              Filter on repository owner
136
137
138       --project <number>
139              Filter on project board number
140
141
142       --reactions <number>
143              Filter on number of reactions
144
145
146       --repo <strings>
147              Filter on repository
148
149
150       --sort <string>
151              Sort   fetched   results:   {comments|created|interactions|reac‐
152              tions|reactions-+1|reactions--1|reactions-heart|reactions-
153              smile|reactions-tada|reactions-thinking_face|updated}
154
155
156       --state <string>
157              Filter based on state: {open|closed}
158
159
160       --team-mentions <string>
161              Filter based on team mentions
162
163
164       -t, --template <string>
165              Format JSON output using a Go template
166
167
168       --updated <date>
169              Filter on last updated at date
170
171
172       --visibility <strings>
173              Filter based on repository visibility: {public|private|internal}
174
175
176       -w, --web
177              Open the search query in the web browser
178
179
180

EXAMPLE

182              # search issues matching set of keywords "readme" and "typo"
183              $ gh search issues readme typo
184
185              # search issues matching phrase "broken feature"
186              $ gh search issues "broken feature"
187
188              # search issues and pull requests in cli organization
189              $ gh search issues --include-prs --owner=cli
190
191              # search open issues assigned to yourself
192              $ gh search issues --assignee=@me --state=open
193
194              # search issues with numerous comments
195              $ gh search issues --comments=">100"
196
197              # search issues without label "bug"
198              $ gh search issues -- -label:bug
199
200
201
202
203

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLE

SEE ALSO