Command referencegh workflow list
gh workflow list command (Linux & Windows / GitHub CLI)
What it does
List GitHub Actions workflows defined in the repository. When people search for gh workflow 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 GitHub Actions workflows defined in the repository.
Syntax
gh workflow list [flags]
Common options
| Flag / option | Meaning |
|---|---|
| -a, --all | Include disabled workflows. |
| -l, --limit | Maximum workflows to list. |
Practical examples
List workflows
gh workflow list
Shows workflow names and IDs for the current repo.
Include disabled
gh workflow list --all
Also lists workflows that are currently disabled.
Common mistakes
- Using a display name when a later command needs the workflow file name or ID.
- Expecting list to show individual runs — use `gh run list` for that.
Related commands
- gh workflow runTrigger a workflow_dispatch event for a GitHub Actions workflow.
- gh run listList recent GitHub Actions workflow runs for the repository.
- gh run viewInspect a GitHub Actions run, including jobs, annotations, and optional logs.
- 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 workflow list do in GitHub CLI?
List GitHub Actions workflows defined in the repository.
Does gh workflow 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 workflow list example?
Try `gh workflow list` — Shows workflow names and IDs for the current repo.
Do I need a token in the command line for gh workflow 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.