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$