# okibi runs

> List your recent generation runs

Generated from okibi 0.2.4. Every command also accepts `--agent`; see [Agent and CI mode](https://okibi.ai/docs/cli/agent-mode.md).

## okibi runs

List your recent generation runs

```sh
okibi runs [flags]
okibi runs [command]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string | https://okibi.ai | Okibi API base URL |
| `--cli` | string |  | only list runs for this CLI |
| `--json` | bool |  | emit the raw run list as JSON |
| `--limit` | int |  | max runs to list (server default 25, cap 50) |
| `--workspace` | string |  | workspace slug to list (or OKIBI_WORKSPACE; default: this machine's default workspace) |

## okibi runs cancel

Cancel a queued, running, or paused generation

```sh
okibi runs cancel <run-id> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string |  | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--yes` | bool |  | confirm this operation |

## okibi runs delete

Delete a failed or cancelled run and its history

```sh
okibi runs delete <run-id> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string |  | Okibi API base URL |
| `--json` | bool |  | emit JSON |
| `--yes` | bool |  | confirm this operation |

## okibi runs history

Read older run history one page at a time

```sh
okibi runs history <cli> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string |  | Okibi API base URL |
| `--cursor` | string |  | cursor returned by the previous page |
| `--json` | bool |  | emit JSON |
| `--limit` | int | 25 | runs per page (1–50) |
| `--workspace` | string |  | workspace slug (or OKIBI_WORKSPACE) |

## okibi runs transcript

Read a saved conversation after its sandbox has gone

```sh
okibi runs transcript <run-id> [flags]
```

Flags:

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--api-url` | string |  | Okibi API base URL |
| `--json` | bool |  | emit JSON |