# List

List recent workflow runs and their state.

### Syntax

```
$ vela workflows list
```

### Options

- `--status <status>` - Only runs in this state: `pending`, `running`, `completed`, `failed` or `canceled`
- `--name <workflow>` - Only runs of this workflow
- `--limit <n>` - How many to show, 50 by default

```
$ vela workflows list --status failed --limit 10
```

Each line shows the run id, the workflow, its state, the attempt count when there has been more than one, when it last changed and, for a failed run, its error. The same runs, with every step, are under **Workflows** in the PocketBase dashboard.

Talks to the database the dev server is using when [`vela dev`](/dev) is running, and starts a throwaway one otherwise.