Scenarios

The scenario command group manages saved budget scenarios — named projection variants you can compare side-by-side. Scenarios replace the older finance budget / finance export-budget commands.

How scenarios work

A scenario is a row in Supabase representing a baseline projection plus an adjustment (percentage or flat). The CLI saves them by name; when you compare two or more, the comparison materializes the projections and surfaces the deltas.

optimal scenario list

List all saved scenarios.

optimal scenario list

Output shows each scenario's name, adjustment type, adjustment value, and last-modified timestamp.

optimal scenario save

Save a new scenario or overwrite an existing one with the same name.

# Baseline +5%
optimal scenario save --name "baseline-plus-5" \
  --adjustment-type percentage \
  --adjustment-value 5

# Flat $10k bump
optimal scenario save --name "flat-10k" \
  --adjustment-type flat \
  --adjustment-value 10000

Flag	Description
--name	Scenario name (required, must be unique or used to overwrite).
--adjustment-type	percentage or flat.
--adjustment-value	Numeric adjustment value. For percentage, units are percent (e.g. 5 = +5%). For flat, units are dollars.

optimal scenario delete

Delete a saved scenario by name.

optimal scenario delete --name "old-scenario"

Flag	Description
--name	Scenario name to delete (required).

optimal scenario compare

Compare two or more scenarios side-by-side. The comparison materializes each scenario's projection from the same baseline and renders a delta table.

optimal scenario compare --names "baseline,baseline-plus-5,flat-10k"

Flag	Description
--names	Comma-separated scenario names (required). At least two needed for a meaningful comparison.

Use this in lieu of the old `finance budget`

The previous optimal finance budget and optimal finance export-budget commands have been removed. Save your common projection variants here once, then compare them as needed.