`maqpna describe`

Show details of resources with related objects and events (kubectl describe)

Observe-o json | yaml

Synopsis#

maqpna describe TYPE [NAME...] | TYPE/NAME... [-n NS | -A] [-l SELECTOR] [--show-events=true|false] [--gateway URL]

Description#

Agents show their tier, ToolPolicies, sovereignty, sessions and budget; AgentSessions their sandbox, pods, snapshots and the gateway's view (cost, taint, pending approvals). TrustTiers, ToolPolicies, MCPServers and snapshots list the objects that use them. Every object ends with its recent events.

Flags#

Flag	Type	Description	Default
`-A`, `--all-namespaces`	switch	all namespaces	none
`--allow-gateway-mismatch`	switch	send the context's login token to a gateway other than the one it was issued for (env MAQPNA_ALLOW_GATEWAY_MISMATCH=1)	none
`--field-selector`	string	field selector evaluated on any field (spec.agentRef=coder,status.phase!=Failed)	none
`--gateway`	string	gateway base URL (env MAQPNA_GATEWAY_URL; default: the context's gateway)	none
`-l`, `--selector`	string	label selector (e.g. app=coder,tier!=t0); Kubernetes kinds	none
`-n`, `--namespace`	string	namespace	`default`
`--oidc-token-file`	string	file holding an OIDC access token for the admin API (env MAQPNA_OIDC_TOKEN_FILE); wins over `--token`	none
`--show-events`	switch	print the recent events of each object	`true`
`--token`	string	static admin token (env MAQPNA_ADMIN_TOKEN; dev/break-glass)	none

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

Examples#

$ maqpna describe ag coder -n team-a
$ maqpna describe sess/coder-x1 -n team-a --gateway https://gw.example.com
$ maqpna describe tt

What happens when you run it#

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.

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)