gh pr list List pull requests in a repository
Shows open pull requests with number, title, branch and state. Filters narrow the list, and it can print JSON for scripts.
Synopsis
gh pr list [FLAGS]
Common options
| Option or form | What it does |
|---|---|
-s, --state open|closed|merged|all | Which state to show (default open) |
-a, --assignee USER | Only those assigned to someone (@me for yourself) |
-A, --author USER | Only those opened by someone |
-l, --label NAME | Only those with a label |
-L, --limit N | Maximum number to list (default 30) |
--json FIELDS | Output the named fields as JSON |
-S, --search QUERY | Filter with GitHub search syntax |
Examples
gh pr list
#42 Add search feature/search about 2 hours ago
gh pr list --author "@me"
gh pr list --state merged --limit 10
gh pr list --search "review:required"
gh pr list --json number,title
Notes
- Run it inside a cloned repository, or add -R owner/repo to look at another one.
- Add --jq with --json to filter the output, for example --jq ".[].number".
- When output is piped, gh switches to tab-separated plain text with no colour.
See also
Last reviewed 2026-10-09.