gh pr list
List and filter pull requests in this repository
gh pr list [flags]
Examples
List PRs authored by you
$ gh pr list --author @me
List PRs assigned to you
$ gh pr list --assignee @me
List PRs by label, combining multiple labels with AND
$ gh pr list --label bug --label "priority 1"
List PRs using search syntax
$ gh pr list --search "status:success review:required"
Open the list of PRs in a web browser
$ gh pr list --web
Options
-a, --assignee string Filter by assignee
-A, --author string Filter by author
-B, --base string Filter by base branch
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-l, --label strings Filter by labels
-L, --limit int Maximum number of items to fetch (default 30)
-S, --search query Search pull requests with query
-s, --state string Filter by state: {open|closed|merged|all} (default "open")
-t, --template string Format JSON output using a Go template
-w, --web Open the browser to list the pull requests
Options inherited from parent commands
--help Show help for command
-R, --repo [HOST/]OWNER/REPO Select another repository using the [HOST/]OWNER/REPO format
In use
Default behavior
You will see the most recent 30 open items.
# Viewing a list of open pull requests
~/Projects/my-project$ gh pr list
Pull requests for owner/repo
#14 Upgrade to Prettier 1.19 prettier
#14 Extend arrow navigation in lists for MacOS arrow-nav
#13 Add Support for Windows Automatic Dark Mode dark-mode
#8 Create and use keyboard shortcut react component shortcut
~/Projects/my-project$
Filtering with flags
You can use flags to filter the list for your specific use cases.
# Viewing a list of closed pull requests assigned to a user
~/Projects/my-project$ gh pr list --state closed --assignee user
Pull requests for owner/repo
#13 Upgrade to Electron 7 electron-7
#8 Release Notes Writing Guide release-notes
~/Projects/my-project$