upstack saved

Cache query parameters locally for reuse. Run, list, inspect, and delete saved queries.

Cache query parameters locally for reuse. Saved queries live in ~/.upstack_saved/, one JSON file per query.

Subcommands

create <name>

upstack saved create morning-report --command query --from-file ./params.json

Flag	Description
--command <c>	Required. One of query, query-attribution, query-cohort, query-channel-details.
--from-file <path>	JSON file with the query parameters.
--description <text>	Optional description for the saved query.

You can also pass query parameters inline as flags (e.g. --measures orders.gross_revenue, --date-start 2026-04-01, --filter '{"and":[...]}') — they’re merged with the file values; flags override file values.

Run upstack filters --detail to discover valid filter fields before constructing a --filter value.

list

upstack saved list

show <name>

Inspect a saved query without running it.

upstack saved show morning-report

run <name>

Re-run a saved query.

upstack saved run morning-report
upstack saved run morning-report --output csv --file ./today.csv   # override output on the fly

delete <name>

upstack saved delete morning-report