Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
GH-EXTENSION-SEARCH(1)		GitHub CLI manual	  GH-EXTENSION-SEARCH(1)

NAME
     gh-extension-search - Search extensions to the GitHub CLI

SYNOPSIS
     gh extension search [<query>] [flags]

DESCRIPTION
     Search for gh extensions.

     With  no  arguments, this command prints out the first 30 extensions avail-
     able to install sorted by number of stars. More extensions can  be  fetched
     by specifying a higher limit with the --limit flag.

     When  connected  to a terminal, this command prints out three columns.  The
     first has a a if the extension is already installed locally. The second  is
     the  full	name of the extension repository in OWNER/REPO format. The third
     is the extension's description.

     When not connected to a terminal, the a character is rendered as  the  word
     "installed"  but  otherwise  the  order  and content of the columns are the
     same.

     This command behaves similarly to gh search repos but does not  support  as
     many  search  qualifiers. For a finer grained search of extensions, try us-
     ing:

     gh search repos --topic "gh-extension"

     and adding qualifiers as needed. See gh help search  repos  to  learn  more
     about repository search.

     For listing just the extensions that are already installed locally, see:

     gh ext list

OPTIONS
     -q, --jq <expression>
	    Filter JSON output using a jq expression

     --json <fields>
	    Output JSON with the specified fields

     --license <strings>
	    Filter based on license type

     -L, --limit <int> (default 30)
	    Maximum number of extensions to fetch

     --order <string> (default "desc")
	    Order  of  repositories  returned,	ignored  unless '--sort' flag is
	    specified: {asc|desc}

     --owner <strings>
	    Filter on owner

     --sort <string> (default "best-match")
	    Sort fetched repositories: {forks|help-wanted-issues|stars|updated}

     -t, --template <string>
	    Format JSON output using a Go template; see "gh help formatting"

     -w, --web
	    Open the search query in the web browser

JSON FIELDS
     createdAt, defaultBranch, description, forksCount, fullName,  hasDownloads,
     hasIssues, hasPages, hasProjects, hasWiki, homepage, id, isArchived, isDis-
     abled,  isFork, isPrivate, language, license, name, openIssuesCount, owner,
     pushedAt, size, stargazersCount, updatedAt, url, visibility, watchersCount

EXIT CODES
     0: Successful execution

     1: Error

     2: Command canceled

     4: Authentication required

     NOTE: Specific commands may have additional exit codes. Refer to  the  com-
     mand's help for more information.

EXAMPLE
     # List the first 30 extensions sorted by star count, descending
     $ gh ext search

     # List more extensions
     $ gh ext search --limit 300

     # List extensions matching the term "branch"
     $ gh ext search branch

     # List extensions owned by organization "github"
     $ gh ext search --owner github

     # List extensions, sorting by recently updated, ascending
     $ gh ext search --sort updated --order asc

     # List extensions, filtering by license
     $ gh ext search --license MIT

     # Open search results in the browser
     $ gh ext search -w

SEE ALSO
     gh-extension(1)

				    Aug 2026		  GH-EXTENSION-SEARCH(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-extension-search&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help