> ## Documentation Index
> Fetch the complete documentation index at: https://www.landbase.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# runs

> List and inspect past agent runs

View and inspect previous agent runs. Each search or workflow step creates a run that can be retrieved by ID or filtered by session.

## runs list

List previous agent runs, optionally filtered by session.

**Usage**

```bash theme={null}
landbase-cli runs list [flags]
```

**Flags**

| Flag                      | Default | Description                              |
| ------------------------- | ------- | ---------------------------------------- |
| `--session=<label-or-id>` | —       | Filter by session label or session ID    |
| `--limit=<n>`             | —       | Maximum number of runs to return         |
| `--no-update-check`       | —       | Skip the daily update check              |
| `--verbose`               | —       | Print request/response details to stderr |

***

## runs get

Get details for a specific run.

**Usage**

```bash theme={null}
landbase-cli runs get <run-id> [flags]
```

<ParamField path="run-id" type="string" required>
  The ID of the run to retrieve.
</ParamField>

**Flags**

| Flag                      | Default | Description                              |
| ------------------------- | ------- | ---------------------------------------- |
| `--session=<label-or-id>` | —       | Session context for the run              |
| `--no-update-check`       | —       | Skip the daily update check              |
| `--verbose`               | —       | Print request/response details to stderr |

**Examples**

```bash theme={null}
# List all runs
landbase-cli runs list

# List runs for a specific session
landbase-cli runs list --session=sf-saas

# Get details for a specific run
landbase-cli runs get <run-id>
```