microagent stop
Last updated: 2026-06-27
microagent stop <name> [--state-dir <dir>]stop asks a workspace to shut down gracefully. If the VM hasn’t exited after
five seconds, stop marks the workspace failed and returns an error. It
never escalates on its own; follow up with kill when you need a
hard termination. When you’re parking a healthy workspace to start again later,
prefer halt, which records the clean halted state.
Examples
Section titled “Examples”Stop a workspace:
microagent stop researchIf the VM doesn’t shut down within the deadline, force it:
microagent kill 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”stop exits 0 on success; nonzero when the workspace cannot be found or when
the VM does not exit within the five-second deadline (the workspace is then
marked failed). In AX mode a failure is written as a structured error
envelope.