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



NAME
       gh-issue-list - List issues in a repository



SYNOPSIS
       gh issue list [flags]



DESCRIPTION
       List issues in a GitHub repository.


       The search query syntax is documented here:

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



OPTIONS
       --app <string>
              Filter by GitHub App author


       -a, --assignee <string>
              Filter by assignee


       -A, --author <string>
              Filter by author


       -q, --jq <expression>
              Filter JSON output using a jq expression


       --json <fields>
              Output JSON with the specified fields


       -l, --label <strings>
              Filter by label


       -L, --limit <int> (default 30)
              Maximum number of issues to fetch


       --mention <string>
              Filter by mention


       -m, --milestone <string>
              Filter by milestone number or title


       -S, --search <query>
              Search issues with query


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


       -t, --template <string>
              Format JSON output using a Go template; see "gh help formatting"


       -w, --web
              List issues in the web browser



OPTIONS INHERITED FROM PARENT COMMANDS
       -R, --repo <[HOST/]OWNER/REPO>
              Select another repository using the [HOST/]OWNER/REPO format



JSON FIELDS
       assignees, author, body, closed, closedAt, comments, createdAt, id,
       labels, milestone, number, projectCards, projectItems, reactionGroups,
       state, title, updatedAt, url



EXAMPLE
       $ gh issue list --label "bug" --label "help wanted"
       $ gh issue list --author monalisa
       $ gh issue list --assignee "@me"
       $ gh issue list --milestone "The big 1.0"
       $ gh issue list --search "error no:assignee sort:created-asc"




SEE ALSO
       gh-issue(1)

                                   May 2024                   GH-ISSUE-LIST(1)