> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# Run Commands

> Inspect trace spans and events, or stream both live.

Inspect trace spans and events, or stream both live.

Output formatting flags (`--json`, `--jq`, and `--template`) are documented once in [Output Formatting](/cli/output) and are omitted from the tables below.

## `bctrl runs list`

List runs

```bash
bctrl runs list [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl runs get`

Get a run

```bash
bctrl runs get <runId>
```

## `bctrl runs trace`

List run trace spans

```bash
bctrl runs trace <runId> [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl runs events`

List run events

```bash
bctrl runs events <runId> [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl runs stream`

Stream trace spans and events from a run

```bash
bctrl runs stream <runId> [flags]
```

| Flag               | Description                  |
| ------------------ | ---------------------------- |
| `--after <cursor>` | Resume after a stream cursor |
| `--include <kind>` | trace or events              |