GH-SEARCH-ISSUES(1) GitHub CLI manual GH-SEARCH-ISSUES(1) NAME gh-search-issues - Search for issues SYNOPSIS gh search issues [<query>] [flags] DESCRIPTION Search for issues 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-is- sues-and-pull-requests> On supported GitHub hosts, advanced issue search syntax can be used in the --search query. For more information about advanced issue search, see: <https://docs.github.com/en/issues/tracking-your-work-with-issues/using-is- sues/filtering-and-searching-issues-and-pull-requests#building-ad- vanced-filters-for-issues> For more information on handling search queries containing a hyphen, run gh search --help. OPTIONS --app <string> Filter by GitHub App author --archived Filter based on the repository archived state {true|false} --assignee <string> Filter by assignee --author <string> Filter by author --closed <date> Filter on closed at date --commenter <user> Filter based on comments by user --comments <number> Filter on number of comments --created <date> Filter based on created at date --include-prs Include pull requests in results --interactions <number> Filter on number of reactions and comments --involves <user> Filter based on involvement of user -q, --jq <expression> Filter JSON output using a jq expression --json <fields> Output JSON with the specified fields --label <strings> Filter on label --language <string> Filter based on the coding language -L, --limit <int> (default 30) Maximum number of results to fetch --locked Filter on locked conversation status --match <strings> Restrict search to specific field of issue: {title|body|comments} --mentions <user> Filter based on user mentions --milestone <title> Filter by milestone title --no-assignee Filter on missing assignee --no-label Filter on missing label --no-milestone Filter on missing milestone --no-project Filter on missing project --order <string> (default "desc") Order of results returned, ignored unless '--sort' flag is speci- fied: {asc|desc} --owner <strings> Filter on repository owner --project <owner/number> Filter on project board owner/number --reactions <number> Filter on number of reactions -R, --repo <strings> Filter on repository --sort <string> (default "best-match") Sort fetched results: {comments|created|interactions|reactions|reac- tions-+1|reactions--1|reactions-heart|reactions-smile|reactions- tada|reactions-thinking_face|updated} --state <string> Filter based on state: {open|closed} --team-mentions <string> Filter based on team mentions -t, --template <string> Format JSON output using a Go template; see "gh help formatting" --updated <date> Filter on last updated at date --visibility <strings> Filter based on repository visibility: {public|private|internal} -w, --web Open the search query in the web browser JSON FIELDS assignees, author, authorAssociation, body, closedAt, commentsCount, cre- atedAt, id, isLocked, isPullRequest, labels, number, repository, state, ti- tle, updatedAt, url 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 # Search issues matching set of keywords "readme" and "typo" $ gh search issues readme typo # Search issues matching phrase "broken feature" $ gh search issues "broken feature" # Search issues and pull requests in cli organization $ gh search issues --include-prs --owner=cli # Search open issues assigned to yourself $ gh search issues --assignee=@me --state=open # Search issues with numerous comments $ gh search issues --comments=">100" # Search issues without label "bug" $ gh search issues -- -label:bug # Search issues only from un-archived repositories (default is all repositories) $ gh search issues --owner github --archived=false SEE ALSO gh-search(1) Aug 2026 GH-SEARCH-ISSUES(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | JSON FIELDS | EXIT CODES | EXAMPLE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-search-issues&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>