## 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.