microagent kill
Last updated: 2026-06-27
microagent kill <name> [--state-dir <dir>]kill is the hard variant of stop. Use it when stop doesn’t
return; stop never escalates on its own. For a clean shutdown of a healthy
workspace you intend to start again, use halt instead. The disk
state survives kill, but nothing inside the guest gets a chance to flush or
exit cleanly.
Examples
Section titled “Examples”Force-terminate a workspace:
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”kill exits 0 on success; nonzero when the workspace cannot be found or the
VM process cannot be terminated. In AX mode a failure is written as a
structured error envelope.