List workflows for a run or recent runs

## Usage

`circleci workflow list [<run-id>] [flags]`

Aliases: `circleci workflow ls`

## Arguments

`<run-id>` is optional: a run UUID (as shown by `circleci run list --json`)
or a run number (as shown by `circleci run list`).

When omitted, workflows for recent runs in the current project are listed,
grouped by run.

## Flags

| Flag                  | Description                                                                       |
| --------------------- | --------------------------------------------------------------------------------- |
| `-b, --branch string` | Filter by branch (recent-runs mode)                                               |
| `--jq string`         | Process values from the response using jq syntax (see `circleci help formatting`) |
| `--json`              | Output as JSON                                                                    |
| `--limit int`         | Number of recent runs to show (recent-runs mode) (default 10)                     |
| `--project string`    | Project slug (e.g. gh/org/repo); defaults to git remote                           |

Global flags: `-c, --config`, `--debug`, `--no-color`, `-q, --quiet` — see `circleci --help`.

## Examples

- List workflows for recent runs in the current project: 
  `circleci workflow list`
- Filter to a specific branch: 
  `circleci workflow list --branch main`
- List workflows by run number: 
  `circleci workflow list 75`
- List workflows by run UUID: 
  `circleci workflow list 9e0c9d52-3b7e-4cd6-b5f7-bfc5e4a07e81`
- Output as JSON: 
  `circleci workflow list --json`

## Details

List workflows for a CircleCI run, or for recent runs in the project when
no run is given.

JSON fields (single run): id, name, phase, outcome, current_outcome.
Recent-runs mode adds run_id.

