Man page - gh-search-repos(1)

Packages contains this manual

Package:  gh
apt-get install gh

Manuals in package:
• gh-repo-edit(1)
• gh-release-view(1)
• gh-pr-list(1)
• gh-project-edit(1)
• gh-run-download(1)
• gh-pr-reopen(1)
• gh-pr-close(1)
• gh-project-delete(1)
• gh-extension-install(1)
• gh-extension-remove(1)
• gh-project-item-delete(1)
• gh-variable-delete(1)
• gh-secret-delete(1)
• gh-project-field-delete(1)
• gh-extension-exec(1)
• gh-gist-edit(1)
• gh-config-clear-cache(1)
• gh-pr-status(1)
• gh-run-view(1)
• gh-ruleset-check(1)
• gh-pr-edit(1)
• gh-codespace-ssh(1)
• gh-repo-deploy-key-add(1)
• gh-issue-delete(1)
• gh-extension(1)
• gh-gist-list(1)
• gh-auth-token(1)
• gh-gist-create(1)
• gh-release-create(1)
• gh-auth-setup-git(1)
• gh-run-watch(1)
• gh-repo-set-default(1)
• gh-secret(1)
• gh-workflow-enable(1)
• gh-ssh-key-delete(1)
• gh-pr-lock(1)
• gh-codespace-delete(1)
• gh-gist-view(1)
• gh-pr-checks(1)
• gh-repo-sync(1)
• gh-run-delete(1)
• gh-release-download(1)
• gh-config-set(1)
• gh-label-create(1)
• gh-extension-create(1)
• gh-repo-view(1)
• gh-issue-list(1)
• gh-project-unlink(1)
• gh-variable(1)
• gh-variable-list(1)
• gh-release-delete-asset(1)
• gh-repo-archive(1)
• gh(1)
• gh-cache-delete(1)
• gh-gpg-key-delete(1)
• gh-status(1)
• gh-pr-ready(1)
• gh-ssh-key(1)
• gh-issue-status(1)
• gh-project-copy(1)
• gh-run-cancel(1)
• gh-variable-set(1)
• gh-run-rerun(1)
• gh-codespace-logs(1)
• gh-release-edit(1)
• gh-pr-diff(1)
• gh-extension-browse(1)
• gh-repo-rename(1)
• gh-workflow-run(1)
• gh-org-list(1)
• gh-search-repos(1)
• gh-org(1)
• gh-project-item-list(1)
• gh-release-list(1)
• gh-project-link(1)
• gh-release-delete(1)
• gh-auth-status(1)
• gh-project-field-list(1)
• gh-search-code(1)
• gh-gist-clone(1)
• gh-alias(1)
• gh-alias-set(1)
• gh-issue-edit(1)
• gh-issue-unpin(1)
• gh-codespace-ports(1)
• gh-issue-pin(1)
• gh-repo(1)
• gh-pr-merge(1)
• gh-issue-develop(1)
• gh-auth-logout(1)
• gh-auth(1)
• gh-workflow(1)
• gh-issue-close(1)
• gh-codespace-ports-forward(1)
• gh-auth-login(1)
• gh-ssh-key-list(1)
• gh-config-get(1)
• gh-codespace-list(1)
• gh-codespace-cp(1)
• gh-config(1)
• gh-config-list(1)
• gh-issue-transfer(1)
• gh-codespace-edit(1)
• gh-project-view(1)
• gh-issue-reopen(1)
• gh-project-field-create(1)
• gh-codespace(1)
• gh-repo-deploy-key-list(1)
• gh-codespace-rebuild(1)
• gh-gpg-key(1)
• gh-alias-import(1)
• gh-project-close(1)
• gh-pr-unlock(1)
• gh-gpg-key-add(1)
• gh-codespace-code(1)
• gh-pr-view(1)
• gh-codespace-stop(1)
• gh-run(1)
• gh-repo-list(1)
• gh-label-clone(1)
• gh-project-list(1)
• gh-extension-upgrade(1)
• gh-issue-comment(1)
• gh-gist-delete(1)
• gh-pr-review(1)
• gh-pr-comment(1)
• gh-cache-list(1)
• gh-auth-switch(1)
• gh-pr(1)
• gh-label-delete(1)
• gh-browse(1)
• gh-alias-delete(1)
• gh-repo-delete(1)
• gh-repo-deploy-key-delete(1)
• gh-cache(1)
• gh-alias-list(1)
• gh-issue-lock(1)
• gh-ruleset-list(1)
• gh-gpg-key-list(1)
• gh-repo-create(1)
• gh-project(1)
• gh-ruleset(1)
• gh-project-item-archive(1)
• gh-extension-search(1)
• gh-pr-create(1)
• gh-workflow-disable(1)
• gh-issue(1)
• gh-gist-rename(1)
• gh-workflow-view(1)
• gh-release(1)
• gh-search-prs(1)
• gh-workflow-list(1)
• gh-issue-create(1)
• gh-label(1)
• gh-project-create(1)
• gh-codespace-create(1)
• gh-search-issues(1)
• gh-ssh-key-add(1)
• gh-issue-view(1)
• gh-search-commits(1)
• gh-gist(1)
• gh-label-list(1)
• gh-codespace-jupyter(1)
• gh-run-list(1)
• gh-label-edit(1)
• gh-completion(1)
• gh-ruleset-view(1)
• gh-codespace-view(1)
• gh-issue-unlock(1)
• gh-auth-refresh(1)
• gh-extension-list(1)
• gh-project-item-create(1)
• gh-secret-set(1)
• gh-search(1)
• gh-repo-clone(1)
• gh-release-upload(1)
• gh-repo-unarchive(1)
• gh-api(1)
• gh-project-mark-template(1)
• gh-project-item-edit(1)
• gh-pr-checkout(1)
• gh-repo-fork(1)
• gh-repo-deploy-key(1)
• gh-codespace-ports-visibility(1)
• gh-secret-list(1)
• gh-project-item-add(1)

Manual

GH-SEARCH-REPOS

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO

---

NAME

gh-search-repos - Search for repositories

SYNOPSIS

gh search repos [<query>] [flags]

DESCRIPTION

Search for repositories on GitHub.

The command supports constructing queries using the GitHub search syntax, using the parameter and qualifier flags, or a combination of the two.

GitHub search syntax is documented at:

⟨ https://docs.github.com/search-github/searching-on-github/searching-for-repositories⟩

OPTIONS

--archived

Filter based on the repository archived state {true|false}

--created <date>

Filter based on created at date

--followers <number>

Filter based on number of followers

--forks <number>

Filter on number of forks

--good-first-issues <number>

Filter on number of issues with the ’good first issue’ label

--help-wanted-issues <number>

Filter on number of issues with the ’help wanted’ label

--include-forks <string>

Include forks in fetched repositories: {false|true|only}

-q , --jq <expression>

Filter JSON output using a jq expression

--json <fields>

Output JSON with the specified fields

--language <string>

Filter based on the coding language

--license <strings>

Filter based on license type

-L , --limit <int> (default 30)

Maximum number of repositories to fetch

--match <strings>

Restrict search to specific field of repository: {name|description|readme}

--number-topics <number>

Filter on number of topics

--order <string> (default "desc")

Order of repositories returned, ignored unless ’--sort’ flag is specified: {asc|desc}

--owner <strings>

Filter on owner

--size <string>

Filter on a size range, in kilobytes

--sort <string> (default "best-match")

Sort fetched repositories: {forks|help-wanted-issues|stars|updated}

--stars <number>

Filter on number of stars

-t , --template <string>

Format JSON output using a Go template; see "gh help formatting"

--topic <strings>

Filter on topic

--updated <date>

Filter on last updated at date

--visibility <strings>

Filter based on visibility: {public|private|internal}

-w , --web

Open the search query in the web browser

EXAMPLE

# search repositories matching set of keywords "cli" and "shell"
$ gh search repos cli shell

# search repositories matching phrase "vim plugin"
$ gh search repos "vim plugin"

# search repositories public repos in the microsoft organization
$ gh search repos --owner=microsoft --visibility=public

# search repositories with a set of topics
$ gh search repos --topic=unix,terminal

# search repositories by coding language and number of good first issues
$ gh search repos --language=go --good-first-issues=">=10"

# search repositories without topic "linux"
$ gh search repos -- -topic:linux

# search repositories excluding archived repositories
$ gh search repos --archived=false

SEE ALSO

gh-search(1)

---