List recent runs for a project

## Usage

`circleci run list [flags]`

Aliases: `circleci run ls`

## Flags

| Flag                   | Description                                                                       |
| ---------------------- | --------------------------------------------------------------------------------- |
| `-b, --branch string`  | Filter by branch                                                                  |
| `-B, --current-branch` | Filter by the currently checked-out branch                                        |
| `--jq string`          | Process values from the response using jq syntax (see `circleci help formatting`) |
| `--json`               | Output as JSON                                                                    |
| `--limit int`          | Maximum number of runs to show [default: 10] (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 recent runs for the current project: 
  `circleci run list`
- Filter to the branch you have checked out: 
  `circleci run list --current-branch`
- Filter to a specific branch: 
  `circleci run list --branch main`
- List runs for an explicit project: 
  `circleci run list --project gh/org/repo`
- Show more results: 
  `circleci run list --limit 25`
- Output as JSON for scripting: 
  `circleci run list --json`

## Details

List recent runs for a CircleCI project.

The project is inferred from the current git repository's remote
unless overridden with --project. Use --branch to filter results
to a single branch, or --current-branch (-B) to automatically use
the branch you have checked out.

The markdown table includes the commit subject; the JSON adds the full
commit and repository detail.

JSON fields: id, phase, outcome, current_outcome, branch, tag, revision, repository_url, commit.subject/url/author_name/author_login, created_at

