`maqpna dev`

Run a local MAQPNA (identity broker, gateway, test MCP server) and your agent under it

Synopsis#

maqpna dev up [--dir .maqpna] [--gateway-port 8080] [--identity-port 8081] [--echo-port 8090] [--policy FILE]
              [--upstream NAME=URL]... [--model NAME=URL[,MODEL]] [--stub-llm [--stub-llm-script F]] [--no-echo] [--from-source]
              [--dlp-profile FILE] [--checkpoint-key FILE] [--gateway-config FILE]
maqpna dev run [--agent coder] [--namespace dev] [--user you@localhost] [--scope S]... [--session S] [--ttl 1h] -- CMD [ARG]...
maqpna dev timeline [--session S | --last] [-o json]
maqpna dev env | status | down

Description#

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.

Subcommands#

maqpna dev upStart a local MAQPNA: identity broker, gateway and the mcp-echo test MCP server maqpna dev runRun a command as an agent session of the local MAQPNA, then print what it did maqpna dev timelineShow each tool call of a local session and the decision on it maqpna dev envPrint the environment variables that point an agent at the local MAQPNA maqpna dev statusShow whether the local MAQPNA servers are running, and their addresses maqpna dev downStop the local MAQPNA servers

Examples#

# Start a local MAQPNA, run your agent under it, then see what it did
$ maqpna dev up
$ maqpna dev run -- python agent.py
$ maqpna dev timeline --last

# Use a model route backed by the scripted stub model
$ maqpna dev up --stub-llm
$ maqpna dev down

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 dev.cast

maqpna dev