# Prompt runs

Prompt run commands retrieve stored results from executed Visibility prompts. They do not start new prompt runs.

## Commands

| Command | Description |
| - | - |
| `lightsage prompts runs list` | List prompt runs. |
| `lightsage prompts runs retrieve --run-id <run_id>` | Retrieve one prompt run. |

## List prompt runs

```bash theme={null}
lightsage prompts runs list --output-format json
```

Filter by prompt, platform, or date range:

```bash theme={null}
lightsage prompts runs list \
  --prompt-id prompt_123 \
  --platform-id chatgpt \
  --start-date 2026-09-01 \
  --end-date 2026-09-06
```

Use `--limit` and `--offset` for pagination:

```bash theme={null}
lightsage prompts runs list --limit 10 --offset 20
```

## Retrieve one prompt run

```bash theme={null}
lightsage prompts runs retrieve --run-id run_123
```

The response includes the run's mentions and citations without exposing raw provider payloads or internal configuration.