Command referencegh release list
gh release list command (Linux & Windows / GitHub CLI)
What it does
List published GitHub releases for the repository. When people search for gh release 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 published GitHub releases for the repository.
Syntax
gh release list [flags]
Common options
| Flag / option | Meaning |
|---|---|
| -L, --limit | Maximum releases to list. |
| --exclude-drafts | Hide draft releases. |
| --exclude-pre-releases | Hide prereleases. |
Practical examples
Recent releases
gh release list
Shows tags, titles, and publication timing.
Stable only
gh release list --exclude-drafts --exclude-pre-releases
Filters toward production releases.
Common mistakes
- Assuming list shows package registry versions — it lists GitHub Releases.
- Forgetting drafts are hidden from some consumers until published.
Related commands
- gh release createCreate a GitHub release with tag, title, notes, and optional assets.
- gh repo viewDisplay metadata about a GitHub repository in the terminal or open it in a browser.
- gh browseOpen a GitHub repository, issue, pull request, or path in the browser.
- 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.
- gh repo cloneClone a GitHub repository to your machine using your authenticated gh settings.
FAQ
What does gh release list do in GitHub CLI?
List published GitHub releases for the repository.
Does gh release 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 release list example?
Try `gh release list` — Shows tags, titles, and publication timing.
Do I need a token in the command line for gh release 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.