maqpna session fork
Fork a session, or start sessions from one of its snapshots
Synopsis#
maqpna session fork S [-n NS] [--name N] [--count N] [--from-snapshot SNAP] [--wait]Description#
From the help of maqpna session:
Sessions are AgentSession objects: start creates one, the operator provisions its sandbox and token. describe merges the object, its sandbox and pods with the gateway's view (cost, taint, pending approvals). exec, files and liveview go through the gateway session API and are governed and audited like any tool call (scope tools:maqpna-exec, admin role).
exec exits with the remote command's exit code. wait exits 1 on timeout or when the session fails.
Flags#
| Flag | Type | Description | Default |
|---|---|---|---|
--count | int | number of children (RL fan-out; prefer --from-snapshot so all start from one state) | 1 |
--from-snapshot | string | fork from this AgentSessionSnapshot instead of the live session | none |
-n, --namespace | string | namespace | default |
--name | string | child name (with --count N: prefix; children are NAME-1..NAME-N) | none |
--timeout | duration | how long --wait waits | 5m0s |
--ttl | duration | child lifetime (default: the source session's ttl) | none |
--wait | switch | wait until every child is Running | none |
The global flags (--context, -o, --no-color, ...) work with every command.
What happens when you run it#
--wait: wait until every child is Running.- 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) |
Related commands#
Terminal demo#
This command needs a Kubernetes cluster with MAQPNA installed, so the recording shows its help. Try it against a cluster from Install.