> ## 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]
```

**run-id** `string` *required*

The ID of the run to retrieve.

**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>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.