prompt runs.md

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

lightsage prompts runs list --output-format json

Filter by prompt, platform, or date range:

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:

lightsage prompts runs list --limit 10 --offset 20

Retrieve one prompt run

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.