gk pr list
Show list of pull requests assigned to you
Synopsis
This command lists the open pull requests where you are the author or assignee. Pass –closed to list closed/merged pull requests instead of open ones. Pass –reviewer to also include pull requests where you are a requested reviewer. Available providers: github, github_enterprise, gitlab, gitlab_self_hosted, bitbucket, bitbucket_server, azure. Use –org/–project/–repo to target a specific repository explicitly (–project is required for Azure). Without those flags, bitbucket, bitbucket_server and azure first try to detect the repository from the current working directory’s origin remote. When the cwd is not a matching clone, bitbucket and azure fall back to listing your PRs across every accessible Bitbucket Cloud workspace or Azure DevOps organization; bitbucket_server has no cross-project fallback, so outside a matching clone it requires –org (the project key) and –repo. Repo-scoped listings already surface PRs you might review, so –reviewer is ignored for those providers.
Pass –all-involvement (with –org/–repo, plus –project for Azure) to list every pull request in the target repository regardless of who authored, is assigned to or is requested to review it. It cannot be combined with –all, and –reviewer is ignored when it is set.
Pass –page
Pass –all-pages to walk every page in one call and return the complete set (all providers: github, github_enterprise, gitlab, gitlab_self_hosted, bitbucket, bitbucket_server, azure). It cannot be combined with –page, and combines with –all, –reviewer and –with-branches. GitHub Search serves at most 1000 results per query facet; a capped facet is reported through a warning.
Results are cached locally for a short window; pass –sync (or -s) to bypass the cache and force a fresh fetch from the provider. –all is not cached.
| Discover values for –org, –project and –repo with ‘gk provider orgs | projects | repos’. |
Examples: gk pr list github gk pr list github –reviewer gk pr list github –closed gk pr list github –sync gk pr list github –page 2 gk pr list github –all-pages –with-branches –json gk pr list bitbucket gk pr list bitbucket –org myws –repo myrepo gk pr list bitbucket_server –org PROJ –repo myrepo gk pr list azure –org myorg –project myproj –repo myrepo gk pr list github –org gitkraken –repo gkcli –all-involvement gk pr list –all –output json
gk pr list [flags]
Examples
pr list <provider>
Options
--all Fetch pull requests from all configured git providers
--all-involvement List every pull request in the target repo regardless of involvement (requires --org/--repo, plus --project for Azure)
--all-pages Fetch every page and return the complete set (all providers; cannot be combined with --page)
--closed List closed/merged pull requests instead of open ones
--connection string Scope the listing to a single connection by its tokenId (see 'gk provider list')
--fields string Comma-separated list of fields to keep in JSON output (e.g. id,title,state); requires --output json
-h, --help help for list
--org string Organization or workspace name to scope listing to (skips cwd detection)
--page int Page number (1-indexed) when paging through pull requests. Pages past the end return empty results. (default 1)
--project string Azure DevOps project name (required with --org/--repo for Azure)
--repo string Repository name to scope listing to (use with --org)
--reviewer Also include pull requests where you are a requested reviewer (supported by every cloud git provider)
-s, --sync Bypass the local cache and force a fresh fetch from the provider
--with-branches Include head/base branch names (GitHub performs one extra API call per PR)
Options inherited from parent commands
--no-telemetry Disable telemetry (OTel spans, Sentry) for this invocation
--output string Output format: text or json (default "text")
--session string (Optional) Isolate auth and cache under a named session
SEE ALSO
- gk pr - Manage your pull requests