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

NAME

6       gh-search-repos - Search for repositories
7
8
9

SYNOPSIS

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

DESCRIPTION

16       Search for repositories 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:
25
26       ⟨https://docs.github.com/search-github/searching-on-github/search‐
27       ing-for-repositories⟩
28
29
30

OPTIONS

32       --archived
33              Filter based on archive state
34
35
36       --created <date>
37              Filter based on created at date
38
39
40       --followers <number>
41              Filter based on number of followers
42
43
44       --forks <number>
45              Filter on number of forks
46
47
48       --good-first-issues <number>
49              Filter on number of issues with the 'good first issue' label
50
51
52       --help-wanted-issues <number>
53              Filter on number of issues with the 'help wanted' label
54
55
56       --include-forks <string>
57              Include forks in fetched repositories: {false|true|only}
58
59
60       -q, --jq <expression>
61              Filter JSON output using a jq expression
62
63
64       --json <fields>
65              Output JSON with the specified fields
66
67
68       --language <string>
69              Filter based on the coding language
70
71
72       --license <strings>
73              Filter based on license type
74
75
76       -L, --limit <int>
77              Maximum number of repositories to fetch
78
79
80       --match <strings>
81              Restrict search to specific field of repository:  {name|descrip‐
82              tion|readme}
83
84
85       --number-topics <number>
86              Filter on number of topics
87
88
89       --order <string>
90              Order  of repositories returned, ignored unless '--sort' flag is
91              specified: {asc|desc}
92
93
94       --owner <strings>
95              Filter on owner
96
97
98       --size <string>
99              Filter on a size range, in kilobytes
100
101
102       --sort <string>
103              Sort fetched  repositories:  {forks|help-wanted-issues|stars|up‐
104              dated}
105
106
107       --stars <number>
108              Filter on number of stars
109
110
111       -t, --template <string>
112              Format JSON output using a Go template; see "gh help formatting"
113
114
115       --topic <strings>
116              Filter on topic
117
118
119       --updated <date>
120              Filter on last updated at date
121
122
123       --visibility <strings>
124              Filter based on visibility: {public|private|internal}
125
126
127       -w, --web
128              Open the search query in the web browser
129
130
131

EXAMPLE

133       # search repositories matching set of keywords "cli" and "shell"
134       $ gh search repos cli shell
135
136       # search repositories matching phrase "vim plugin"
137       $ gh search repos "vim plugin"
138
139       # search repositories public repos in the microsoft organization
140       $ gh search repos --owner=microsoft --visibility=public
141
142       # search repositories with a set of topics
143       $ gh search repos --topic=unix,terminal
144
145       # search repositories by coding language and number of good first issues
146       $ gh search repos --language=go --good-first-issues=">=10"
147
148       # search repositories without topic "linux"
149       $ gh search repos -- -topic:linux
150
151
152
153
154

SEE ALSO

156       gh-search(1)
157
158
159
160                                   Nov 2023                 GH-SEARCH-REPOS(1)
Impressum