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

NAME

6       gh-extension-search - Search extensions to the GitHub CLI
7
8
9

SYNOPSIS

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

DESCRIPTION

16       Search for gh extensions.
17
18
19       With  no  arguments,  this  command  prints out the first 30 extensions
20       available to install sorted by number of stars. More extensions can  be
21       fetched by specifying a higher limit with the --limit flag.
22
23
24       When  connected  to  a terminal, this command prints out three columns.
25       The first has a ✓ if the extension is already  installed  locally.  The
26       second  is the full name of the extension repository in NAME/OWNER for‐
27       mat. The third is the extension's description.
28
29
30       When not connected to a terminal, the ✓ character is  rendered  as  the
31       word  "installed" but otherwise the order and content of the columns is
32       the same.
33
34
35       This command behaves similarly to 'gh search repos' but does  not  sup‐
36       port  as  many  search qualifiers. For a finer grained search of exten‐
37       sions, try using:
38
39
40              gh search repos --topic "gh-extension"
41
42
43
44       and adding qualifiers as needed. See 'gh help search  repos'  to  learn
45       more about repository search.
46
47
48       For  listing  just  the  extensions that are already installed locally,
49       see:
50
51
52              gh ext list
53
54
55
56

OPTIONS

58       -q, --jq <expression>
59              Filter JSON output using a jq expression
60
61
62       --json <fields>
63              Output JSON with the specified fields
64
65
66       --license <strings>
67              Filter based on license type
68
69
70       -L, --limit <int>
71              Maximum number of extensions to fetch
72
73
74       --order <string>
75              Order of repositories returned, ignored unless '--sort' flag  is
76              specified: {asc|desc}
77
78
79       --owner <string>
80              Filter on owner
81
82
83       --sort <string>
84              Sort  fetched  repositories: {forks|help-wanted-issues|stars|up‐
85              dated}
86
87
88       -t, --template <string>
89              Format JSON output using a Go template; see "gh help formatting"
90
91
92       -w, --web
93              Open the search query in the web browser
94
95
96

EXAMPLE

98              # List the first 30 extensions sorted by star count, descending
99              $ gh ext search
100
101              # List more extensions
102              $ gh ext search --limit 300
103
104              # List extensions matching the term "branch"
105              $ gh ext search branch
106
107              # List extensions owned by organization "github"
108              $ gh ext search --owner github
109
110              # List extensions, sorting by recently updated, ascending
111              $ gh ext search --sort updated --order asc
112
113              # List extensions, filtering by license
114              $ gh ext search --license MIT
115
116              # Open search results in the browser
117              $ gh ext search -w
118
119
120
121
122

SEE ALSO

124       gh-extension(1)
125
126
127
128                                   Jan 2023             GH-EXTENSION-SEARCH(1)
Impressum