gh pr list

List pull requests

What it does

gh pr list lists the open pull requests: number, title, branch and when each was created. It shows 30 by default; --limit changes that.

Filters: --author @me for your own, --label by label, --state merged or --state all for more than the open ones. --search takes a query in GitHub search syntax, such as --search "review:required".

Syntax

gh pr list
gh pr list --author @me
gh pr list --state <open|closed|merged|all>

Examples

• List the repository's open pull requests

  gh pr list

  • pr — pull requests
  • list — list; open ones by default

• List only your own open pull requests

  gh pr list --author @me

  same as: gh pr list -A @me, gh pr list --author "@me"

  • pr list — list pull requests
  • --author — filter by author
  • @me — yourself

Related commands

• gh pr view — Read a pull request: description, status and reviews
• gh pr status — A summary: the current branch's PR, your PRs and review requests
• gh issue list — List issues

Practise · All commands