gh issue list

gh issue list [flags]

List issues in a GitHub repository.

The search query syntax is documented here:


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


$ 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

In use

Default behavior

You will see the most recent 30 open items.

# Viewing a list of open issues
~/Projects/my-project$ gh issue list

Issues for owner/repo

#14  Update the remote url if it changed  (bug)
#14  PR commands on a detached head       (enhancement)
#13  Support for GitHub Enterprise        (wontfix)
#8   Add an easier upgrade command        (bug)


Filtering with flags

You can use flags to filter the list for your specific use cases.

# Viewing a list of closed issues assigned to a user
~/Projects/my-project$ gh issue list --state closed --assignee user

Issues for owner/repo

#13  Enable discarding submodule changes  (bug)
#8   Upgrade to latest react              (upgrade)