Read commands

All read commands accept --workspace <uuid> when you have multiple workspaces.

workspaces

Lists id, name, state for every non-archived workspace you can access.

metrics sov

Share-of-voice snapshots for the workspace primary brand (brand_metrics_snapshots, period_type=run).

runs

• runs list [--limit N] — recent benchmark runs (default 50)
• runs get <run_id> — full run detail

Treat status=partial like completed for metrics.

prompts

• prompts list — table data for the latest completed run
• prompts get <prompt_id> — version + response debug info

topics list

Topic tree with nested prompts (getTopicsTreeData).

alerts list

Use --open for unacknowledged alerts only.

competitors

Competitor brands with latest rollup metrics.