GH-PR-LIST(1)                  GitHub CLI manual                 GH-PR-LIST(1)



<?><?><?> (NAME)
       gh-pr-list - <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       gh pr list [flags]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       PR<?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?>:

       <https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests>


       <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> --search
       <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>:

       <https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests#building-advanced-filters-for-issues>



<?><?><?><?><?><?><?><?> (OPTIONS)
       --app <string>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> (GitHub App)
              <?><?><?><?><?><?><?><?><?><?>


       -a, --assignee <string>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?>


       -A, --author <string>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?> --app <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>)


       -B, --base <string>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?>


       -d, --draft
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> (draft)


       -H, --head <string>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?> (<?><?><?> ":" <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>)


       -q, --jq <expression>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> JSON <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> jq


       --json <fields>
              <?><?><?><?><?> JSON <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>


       -l, --label <strings>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>


       -L, --limit <int> (default 30)
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>


       -S, --search <query>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?>


       -s, --state <string> (default "open")
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?>: {open|closed|merged|all}


       -t, --template <string>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> JSON <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> Go<?>
              <?><?><?><?><?> "gh help formatting" <?><?> <?><?><?><?><?><?>


       -w, --web
              <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?>



<?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> (OPTIONS INHERITED FROM PARENT
       COMMANDS)
       -R, --repo <[HOST/]OWNER/REPO>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> [HOST/]OWNER/REPO



<?><?><?><?><?><?><?> <?><?><?><?><?><?> (ALIASES)
       gh pr ls



<?><?><?><?><?><?><?> JSON (JSON FIELDS)
       additions, assignees, author, autoMergeRequest, baseRefName,
       baseRefOid, body, changedFiles, closed, closedAt,
       closingIssuesReferences, comments, commits, createdAt, deletions,
       files, fullDatabaseId, headRefName, headRefOid, headRepository,
       headRepositoryOwner, id, isCrossRepository, isDraft, labels,
       latestReviews, maintainerCanModify, mergeCommit, mergeStateStatus,
       mergeable, mergedAt, mergedBy, milestone, number, potentialMergeCommit,
       projectCards, projectItems, reactionGroups, reviewDecision,
       reviewRequests, reviews, state, statusCheckRollup, title, updatedAt,
       url



<?><?><?><?><?> <?><?><?><?> (EXIT CODES)
       0: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>


       1: <?><?><?>


       2: <?><?><?><?><?> <?><?><?> <?><?>


       4: <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>


       <?><?><?><?>: <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       # <?><?><?><?><?> <?><?><?><?> PR<?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       $ gh pr list --author "@me"

       # <?><?><?><?><?> <?><?><?><?> PR<?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> Dependabot
       $ gh pr list --app dependabot

       # <?><?><?><?><?> <?><?><?><?> PR<?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       $ gh pr list --head "typo"

       # <?><?><?> <?><?><?><?><?> <?><?><?><?> PR<?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       $ gh pr list --label bug --label "priority 1"

       # <?><?><?><?><?> <?><?><?><?> PR<?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       $ gh pr list --search "status:success review:required"

       # <?><?><?><?><?> PR <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       $ gh pr list --search "<SHA>" --state merged




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gh-pr(1)

                                   Sep 2026                      GH-PR-LIST(1)