Scroll to navigation

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-issues-and-pull-requests⟩

OPTIONS

Filter by GitHub App author

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

Filter by assignee

Filter by author

Filter on closed at date

Filter based on comments by user

Filter on number of comments

Filter based on created at date

Include pull requests in results

Filter on number of reactions and comments

Filter based on involvement of user

Filter JSON output using a jq expression

Output JSON with the specified fields

Filter on label

Filter based on the coding language

Maximum number of results to fetch

Filter on locked conversation status

Restrict search to specific field of issue: {title|body|comments}

Filter based on user mentions

Filter by milestone title

Filter on missing assignee

Filter on missing label

Filter on missing milestone

Filter on missing project

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

Filter on repository owner

Filter on project board number

Filter on number of reactions

Filter on repository

Sort fetched results: {comments|created|interactions|reactions|reactions-+1|reactions--1|reactions-heart|reactions-smile|reactions-tada|reactions-thinking_face|updated}

Filter based on state: {open|closed}

Filter based on team mentions

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

Filter on last updated at date

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

Open the search query in the web browser

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)

Apr 2024 GitHub CLI v2.48.0