gh pr list
List and filter pull requests in this repository
gh pr list [flags]
Options
-a,--assignee <string>- Filter by assignee
-A,--author <string>- Filter by author
-B,--base <string>- Filter by base branch
-d,--draft- Filter by draft state
-H,--head <string>- Filter by head 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
-S,--search <query>- Search pull requests with query
-s,--state <string>- Filter by state: {open|closed|merged|all}
-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
-R,--repo <[HOST/]OWNER/REPO>- Select another repository using the [HOST/]OWNER/REPO format
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
See also
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$