Man page - gh-search-prs(1)
Packages contas this manual
- gh-project-link(1)
- gh-gist-delete(1)
- gh-project-delete(1)
- gh-codespace-create(1)
- gh-extension(1)
- gh-issue-status(1)
- gh-release-view(1)
- gh-config-clear-cache(1)
- gh-pr-checks(1)
- gh-gist-rename(1)
- gh-auth-status(1)
- gh-search-repos(1)
- gh-alias-list(1)
- gh-variable-set(1)
- gh-repo-unarchive(1)
- gh-issue-view(1)
- gh-ruleset-list(1)
- gh-repo-create(1)
- gh-secret-set(1)
- gh-repo-set-default(1)
- gh-ssh-key-list(1)
- gh-auth-switch(1)
- gh-gist-clone(1)
- gh-pr-checkout(1)
- gh-extension-exec(1)
- gh-project-item-delete(1)
- gh-pr-reopen(1)
- gh-variable(1)
- gh-gpg-key(1)
- gh-codespace-ports-forward(1)
- gh-project-item-edit(1)
- gh-browse(1)
- gh-codespace-delete(1)
- gh-project-item-list(1)
- gh-issue-reopen(1)
- gh-release-upload(1)
- gh-issue-transfer(1)
- gh-project-item-create(1)
- gh-extension-create(1)
- gh-repo-deploy-key-delete(1)
- gh-issue-comment(1)
- gh-cache-delete(1)
- gh-release(1)
- gh(1)
- gh-status(1)
- gh-org(1)
- gh-run-view(1)
- gh-repo-edit(1)
- gh-repo-deploy-key(1)
- gh-gist-view(1)
- gh-extension-upgrade(1)
- gh-extension-browse(1)
- gh-label-edit(1)
- gh-api(1)
- gh-variable-list(1)
- gh-workflow-run(1)
- gh-project-mark-template(1)
- gh-repo-deploy-key-list(1)
- gh-secret-delete(1)
- gh-workflow-list(1)
- gh-gist-list(1)
- gh-repo(1)
- gh-pr-diff(1)
- gh-pr-review(1)
- gh-workflow(1)
- gh-release-delete(1)
- gh-extension-remove(1)
- gh-codespace-cp(1)
- gh-run-list(1)
- gh-repo-sync(1)
- gh-release-list(1)
- gh-codespace-code(1)
- gh-codespace-ssh(1)
- gh-search-issues(1)
- gh-secret(1)
- gh-completion(1)
- gh-auth-token(1)
- gh-issue(1)
- gh-project-field-create(1)
- gh-gpg-key-add(1)
- gh-variable-delete(1)
- gh-label-delete(1)
- gh-alias-delete(1)
- gh-ssh-key-add(1)
- gh-repo-clone(1)
- gh-extension-search(1)
- gh-search-code(1)
- gh-alias(1)
- gh-release-edit(1)
- gh-auth-logout(1)
- gh-cache(1)
- gh-issue-pin(1)
- gh-pr-create(1)
- gh-pr-view(1)
- gh-release-download(1)
- gh-secret-list(1)
- gh-alias-import(1)
- gh-repo-rename(1)
- gh-config-get(1)
- gh-project-view(1)
- gh-project(1)
- gh-codespace-edit(1)
- gh-repo-delete(1)
- gh-run(1)
- gh-extension-install(1)
- gh-auth-login(1)
- gh-pr-status(1)
- gh-ruleset-check(1)
- gh-codespace-logs(1)
- gh-run-delete(1)
- gh-gist(1)
- gh-pr-unlock(1)
- gh-gist-create(1)
- gh-project-copy(1)
- gh-issue-list(1)
- gh-codespace-ports(1)
- gh-extension-list(1)
- gh-repo-archive(1)
- gh-issue-unlock(1)
- gh-issue-close(1)
- gh-project-item-archive(1)
- gh-project-close(1)
- gh-project-list(1)
- gh-run-cancel(1)
- gh-workflow-enable(1)
- gh-run-rerun(1)
- gh-issue-create(1)
- gh-issue-edit(1)
- gh-project-edit(1)
- gh-ssh-key(1)
- gh-gpg-key-list(1)
- gh-label-list(1)
- gh-label(1)
- gh-release-delete-asset(1)
- gh-pr-comment(1)
- gh-project-field-delete(1)
- gh-codespace-rebuild(1)
- gh-search(1)
- gh-gist-edit(1)
- gh-run-download(1)
- gh-issue-unpin(1)
- gh-repo-deploy-key-add(1)
- gh-config-set(1)
- gh-project-field-list(1)
- gh-pr-list(1)
- gh-search-commits(1)
- gh-codespace-list(1)
- gh-pr-lock(1)
- gh-pr-merge(1)
- gh-cache-list(1)
- gh-codespace-view(1)
- gh-ruleset(1)
- gh-auth-refresh(1)
- gh-workflow-disable(1)
- gh-project-unlink(1)
- gh-release-create(1)
- gh-issue-lock(1)
- gh-gpg-key-delete(1)
- gh-org-list(1)
- gh-search-prs(1)
- gh-repo-fork(1)
- gh-ssh-key-delete(1)
- gh-repo-list(1)
- gh-issue-develop(1)
- gh-project-create(1)
- gh-workflow-view(1)
- gh-codespace-ports-visibility(1)
- gh-alias-set(1)
- gh-codespace-jupyter(1)
- gh-ruleset-view(1)
- gh-label-create(1)
- gh-config-list(1)
- gh-project-item-add(1)
- gh-pr-edit(1)
- gh-pr-close(1)
- gh-issue-delete(1)
- gh-repo-view(1)
- gh-label-clone(1)
- gh-pr(1)
- gh-auth-setup-git(1)
- gh-pr-ready(1)
- gh-run-watch(1)
- gh-codespace-stop(1)
- gh-codespace(1)
- gh-config(1)
- gh-auth(1)
Package: gh
apt-get install gh
apt-get install gh
Manuals in package:
Manual
| 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-issues-and-pull-requests⟩
OPTIONS
- --app <string>
- Filter by GitHub App author
- --archived
- Filter based on the repository archived state {true|false}
- --assignee <string>
- Filter by assignee
- 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 specified: {asc|desc}
- --owner <strings>
- Filter on repository owner
- --project <number>
- Filter on project board 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_requested}
- --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|reactions--1|reactions-smile|reactions-thinking_face|reactions-heart|reactions-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
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)
| Jan 2025 |