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       gh search repos --topic "gh-extension"
40
41
42
43       and adding qualifiers as needed. See 'gh help search  repos'  to  learn
44       more about repository search.
45
46
47       For  listing  just  the  extensions that are already installed locally,
48       see:
49
50       gh ext list
51
52
53
54

OPTIONS

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

EXAMPLE

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

SEE ALSO

122       gh-extension(1)
123
124
125
126                                   Nov 2023             GH-EXTENSION-SEARCH(1)
Impressum