MAQPNADocs

maqpna agent list

List agents

Run agents-o json | yaml

Synopsis#

maqpna agent list [-n NS | -A]

Description#

From the help of maqpna agent:

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.

Flags#

FlagTypeDescriptionDefault
-A, --all-namespacesswitchall namespacesnone
-n, --namespacestringnamespacedefault

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

Examples#

maqpna agent list -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#

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

Terminal demo#

maqpna agent list --help.cast

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