GH-SEARCH-PRS(1) GitHub CLI manual GH-SEARCH-PRS(1) NAME gh-search-prs - Search for pull requests SYNOPSIS gh search prs [<query>] [flags] DESCRIPTION Search for pull requests 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 -B, --base <string> Filter on base branch name --checks <string> Filter based on status of the checks: {pending|success|failure} --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 --draft Filter based on draft state -H, --head <string> Filter on head branch name --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 --merged Filter based on merged state --merged-at <date> Filter on merged at date --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 --review <string> Filter based on review status: {none|required|approved|changes_re- quested} --review-requested <user> Filter on user or team requested to review --reviewed-by <user> Filter on user who reviewed --sort <string> (default "best-match") Sort fetched results: {comments|reactions|reactions-+1|reac- tions--1|reactions-smile|reactions-thinking_face|reactions-heart|re- actions-tada|interactions|created|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, isDraft, isLocked, isPullRequest, labels, number, repository, state, title, 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 pull requests matching set of keywords "fix" and "bug" $ gh search prs fix bug # Search draft pull requests in cli repository $ gh search prs --repo=cli/cli --draft # Search open pull requests requesting your review $ gh search prs --review-requested=@me --state=open # Search merged pull requests assigned to yourself $ gh search prs --assignee=@me --merged # Search pull requests with numerous reactions $ gh search prs --reactions=">100" # Search pull requests without label "bug" $ gh search prs -- -label:bug # Search pull requests only from un-archived repositories (default is all repositories) $ gh search prs --owner github --archived=false SEE ALSO gh-search(1) Aug 2026 GH-SEARCH-PRS(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-prs&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>