microagent supervise
microagent supervise <name> [--state-dir <dir>] [--max-restarts <n>]supervise is a foreground host supervisor. It starts a workspace and keeps
watching it while the command is running. When the workspace reaches a terminal
state, the persisted restart policy decides whether supervise starts it
again.
Restart policies
Section titled “Restart policies”| Policy | Behavior |
|---|---|
never | Do not start under supervise |
on-failure | Restart only after a failed state |
always | Restart after stopped or failed |
The policy comes from microagent create --restart ... or restart: in
microagent.yaml.
| Flag | Description |
|---|---|
--state-dir <dir> | State directory holding the workspace record |
--supervisor <path> | Override the installed host backend supervisor path |
--arch <arch> | Guest architecture |
--kernel <path> | Kernel path |
--interval <seconds> | Seconds between state checks |
--max-restarts <n> | Maximum restarts; 0 means unlimited |
Example
Section titled “Example”microagent create research --restart alwaysmicroagent supervise researchStop the foreground supervise process to stop restart supervision.