Opportunities - Lightsage

Opportunities are ranked action items computed from stored prompt visibility results. Each opportunity includes an execution_prompt with context for an AI agent.

Commands

Command	Description
`lightsage opportunities list`	List ranked opportunities.
`lightsage opportunities retrieve --opportunity-id <opportunity_id>`	Retrieve one opportunity.

List opportunities

lightsage opportunities list --output-format json

Filter by category, type, or date window:

lightsage opportunities list \
  --category quick_wins \
  --opportunity-type citation_gaps \
  --since 30d

Override the date window with explicit dates:

lightsage opportunities list \
  --start-date 2026-08-01 \
  --end-date 2026-08-31 \
  --limit 25

Retrieve one opportunity

lightsage opportunities retrieve --opportunity-id opp_123

The detail response includes the opportunity’s execution context for the selected date window.