`maqpna costs summary`

Summarize spend by namespace, agent or user for a day or month

Observe-o json | yaml

Synopsis#

maqpna costs summary [--gateway URL] [--scope total|namespace|agent|user] [--window day|month] [--at RFC3339] [--session ID]

Flag	Type	Description	Default
`--at`	string	RFC3339 instant inside the window (default now)	none
`--gateway`	string	gateway base URL (env MAQPNA_GATEWAY_URL; default: the context's gateway)	none
`--oidc-token-file`	string	file holding an OIDC access token for the admin API (env MAQPNA_OIDC_TOKEN_FILE); wins over `--token`	none
`--scope`	string	total \| namespace \| agent \| user (windowed totals; default: running totals since start)	none
`--session`	string	one session's cost and budget status	none
`--token`	string	static admin token (env MAQPNA_ADMIN_TOKEN; dev/break-glass)	none
`--window`	string	day \| month (with `--scope`; default month)	none

The global flags (--context, -o, --no-color, ...) work with every command.

$ maqpna costs summary --scope agent --window month

Talks to the gateway: --gateway, else MAQPNA_GATEWAY_URL, else the current context's gateway (maqpna context).
Authenticates to the admin API with the token stored by maqpna login, --oidc-token-file, or a static --token (MAQPNA_ADMIN_TOKEN).
Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.

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)

maqpna costs summary.cast