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



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



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



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


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

       <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 <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>)


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


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


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


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


       --mention <string>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>


       -m, --milestone <string>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>


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


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


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


       --type <name>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?>


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



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



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



<?><?><?><?><?><?><?> JSON (JSON FIELDS)
       assignees, author, blockedBy, blocking, body, closed, closedAt,
       closedByPullRequestsReferences, comments, createdAt, id, isPinned,
       issueType, labels, milestone, number, parent, projectCards,
       projectItems, reactionGroups, state, stateReason, subIssues,
       subIssuesSummary, title, updatedAt, url



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


       1: <?><?><?>


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


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


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



<?><?><?><?><?><?><?> (EXAMPLES)
       $ gh issue list --label "bug" --label "help wanted"
       $ gh issue list --author monalisa
       $ gh issue list --app dependabot
       $ gh issue list --assignee "@me"
       $ gh issue list --milestone "The big 1.0"
       $ gh issue list --search "error no:assignee sort:created-asc"
       $ gh issue list --state all
       $ gh issue list --type Bug




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

                                   Sep 2026                   GH-ISSUE-LIST(1)