`maqpna agent`

List and inspect agents

Run agents-o json | yamlalias: agents

Synopsis#

maqpna agent list [-n NS | -A]
maqpna agent get NAME [-n NS]
maqpna agent describe NAME [-n NS]

Description#

describe adds the trust tier, the ToolPolicies that apply, sovereignty compliance, the agent's sessions by phase and its budget. In kubectl the Agent kind's short name is mqagent (kubectl get mqagent), since "agents" collides with kagent's agents.kagent.dev.

Subcommands#

maqpna agent listList agents maqpna agent getShow one agent object maqpna agent describeDescribe an agent: trust tier, policies, sovereignty, sessions and budget

Examples#

$ maqpna agent list -A
$ maqpna agent describe coder -n team-a

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 agent --help.cast

This command needs a Kubernetes cluster with MAQPNA installed, so the recording shows its help. Try it against a cluster from Install.

maqpna agent