maqpna dev run
Run a command as an agent session of the local MAQPNA, then print what it did
Synopsis#
maqpna dev run [--agent coder] [--namespace dev] [--user you@localhost] [--scope S]... [--session S] [--ttl 1h] -- CMD [ARG]...Description#
From the help of maqpna dev:
up starts maqpna-identity, maqpna-gateway and (unless --no-echo) mcp-echo from the installed binaries (next to maqpna or on PATH); in a source checkout with --from-source, or when they are missing, they are built with go build. run mints a session token from the local broker and runs CMD with the same environment the operator gives a sandbox (MAQPNA_GATEWAY_URL, MAQPNA_TOKEN, MAQPNA_SESSION, MAQPNA_AGENT, MAQPNA_TOOL_<NAME>_URL), then prints what the session did. Exit code: CMD's.
Flags#
| Flag | Type | Description | Default |
|---|---|---|---|
--agent | string | agent name (token claim; policies match on it) | coder |
--dir | string | state directory (keys, config, ledger, logs) | .maqpna |
--namespace | string | namespace (token claim) | dev |
--scope | string | token scope (repeatable; default: tools:<each MCP server> and models:*) | none |
--session | string | session id (default: dev-<random>) | none |
--ttl | duration | token lifetime | 1h0m0s |
--user | string | on-behalf-of user | you@localhost |
The global flags (--context, -o, --no-color, ...) work with every command.
Examples#
maqpna dev run -- python agent.pyWhat happens when you run it#
- Prints a table by default;
-o jsonor-o yamlprint the data, and--jq EXPRfilters 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) |
CMD | the exit code of the command it ran |