Skip to content

`maqpna costs`

Export costs in FOCUS, the FinOps cost-export format

Observe-o json | yaml

Synopsis#

maqpna costs focus [--gateway URL | --ledger FILE] [--since RFC3339] [--until RFC3339] [--format csv|json] [--period 1h] [--out FILE]
maqpna costs summary [--gateway URL] [--scope total|namespace|agent|user] [--window day|month] [--at RFC3339] [--session ID]

Subcommands#

maqpna costs focusExport costs in FOCUS format (CSV or JSON) maqpna costs summarySummarize spend by namespace, agent or user for a day or month

Examples#

$ maqpna costs summary --scope agent --window month
$ maqpna costs focus --gateway "$GW" --since 2026-09-01T00:00:00Z --format csv --out costs.csv

What happens when you run it#

Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.

Exit codes#

Code	Meaning
`0`	success
`1`	error (the message says what failed, with a hint when there is one)
`2`	usage error: unknown flag, missing argument or bad value; the synopsis is printed
`3`	a check failed, a change is blocked, or a result did not match (tamper, policy mismatch) (not used by this command)

Terminal demo#

maqpna costs.cast