microagent resume
Last updated: 2026-06-27
microagent resume <name> [--state-dir <dir>]resume thaws a paused workspace and records its state as
running again. The VM’s vCPUs continue executing from exactly where they were
frozen, with guest memory, disk state, and the host-side network, port
forwarding, and vsock paths intact. After resume, exec,
connect, and stats work again.
resume requires the workspace to be paused. To boot a halted or stopped
workspace from disk, use start.
Examples
Section titled “Examples”Freeze a workspace, then thaw it:
microagent pause researchmicroagent resume researchYou’ll rarely need flags here - --state-dir only when the workspace lives
outside the default ~/.microagent/.
| Flag | Description |
|---|---|
--name <name> | Workspace name; positional name is also accepted |
--id <id> | Workspace ID alias for --name |
--state-dir <dir> | State directory holding the workspace record (default ~/.microagent/) |
--backend <name> | Backend identity override |
--supervisor <path> | Override the installed host backend supervisor path |
See global flags for --json/--text/--output/--mode/--supervisor.
Exit status
Section titled “Exit status”resume exits 0 when the VM is running again; nonzero when the workspace
cannot be found, is not paused, or when the backend cannot thaw the VM. In AX
mode a failure is written as a structured error envelope.