gh issue list
gh issue list [flags]
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>
- 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>
- 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
Examples
$ 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)
~/Projects/my-project$
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)
~/Projects/my-project$