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

FreeBSD Manual Pages

  
 
  

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
       available 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	if the extension is  already  installed	 locally.  The
       second  is the full name	of the extension repository in OWNER/REPO for-
       mat. The	third is the extension's description.

       When not	connected to a terminal, the  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 using:

       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|up-
	      dated}

       -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,  hasDown-
       loads,  hasIssues,  hasPages,  hasProjects,  hasWiki, homepage, id, is-
       Archived,  isDisabled,  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
       command'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)

				   Apr 2025		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+14.3.quarterly>

home | help