Command referencegh issue list
gh issue list command (Linux & Windows / GitHub CLI)
What it does
List issues in the current or specified GitHub repository with filters. When people search for gh issue list, they usually want practical GitHub CLI flags, safe examples, and how this subcommand fits everyday PR and repo workflows on Linux, Windows, and macOS. Syntax, options, and copyable examples are below.
List issues in the current or specified GitHub repository with filters.
Syntax
gh issue list [flags]
Common options
| Flag / option | Meaning |
|---|---|
| -s, --state | Filter by open, closed, or all. |
| -a, --assignee | Filter by assignee login. |
| -l, --label | Filter by label. |
| -S, --search | Search query string. |
| -L, --limit | Maximum issues to list. |
| -w, --web | Open the issues page in a browser. |
Practical examples
Open issues
gh issue list
Lists open issues for the current repository.
By label
gh issue list --label bug
Shows open issues tagged bug.
Assigned to me
gh issue list --assignee @me
Filters to issues assigned to the authenticated user.
Search text
gh issue list -S "crash report"
Uses GitHub search syntax within issues.
Common mistakes
- Forgetting `-s all` when looking for recently closed issues.
- Running outside a git repo without `-R OWNER/REPO`.
Related commands
- gh issue createOpen a new GitHub issue from the terminal with title, body, labels, and assignees.
- gh issue viewShow details for a GitHub issue in the terminal or open it on the web.
- gh issue closeClose one or more GitHub issues from the command line.
- gh pr listList pull requests in a repository with state, author, and search filters.
- gh auth loginAuthenticate the GitHub CLI with GitHub.com or GitHub Enterprise so other gh commands can run.
- gh pr createCreate a pull request from the current branch with title, body, reviewers, and base branch options.
- gh pr mergeMerge a pull request using merge commit, squash, or rebase strategies.
- gitTrack source history and collaborate through distributed repositories.
FAQ
What does gh issue list do in GitHub CLI?
List issues in the current or specified GitHub repository with filters.
Does gh issue list work on Windows and Linux?
Yes. The GitHub CLI (`gh`) runs on Linux, Windows, and macOS with the same subcommand syntax after you authenticate with `gh auth login`.
What is a practical gh issue list example?
Try `gh issue list` — Lists open issues for the current repository.
Do I need a token in the command line for gh issue list?
Prefer `gh auth login` so credentials stay in the system keyring or secure storage. Avoid pasting personal access tokens into shell history.
Browse the full Linux and Windows command reference to search more bash, CMD, PowerShell, Conda, and GitHub CLI commands.