microagent halt
microagent halt <name> [--state-dir <dir>]halt requests a clean shutdown and records the terminal state as halted.
The VM process exits, but the workspace rootfs, attached disks, identity, and
event timeline remain under --state-dir so a later microagent start <name>
boots the same disk state.
This is not memory pause/resume. A restarted workspace boots again from the preserved disk.
| Flag | Description |
|---|---|
--state-dir <dir> | State directory holding the workspace record |
--supervisor <path> | Override the installed host backend supervisor path |
Example
Section titled “Example”microagent halt researchmicroagent start research