Skip to content

microagent delete

microagent delete <name> [--yes] [--force] [--state-dir <dir>]

delete removes the workspace record and its on-disk artifacts (rootfs, bundles, state file).

By default, delete asks for confirmation. If the workspace is running, it asks whether to stop and delete it. Use --yes for non-interactive cleanup. Use --force to kill a running workspace before deleting it.

FlagDescription
--state-dir <dir>State directory holding the workspace record
--supervisor <path>Override the installed host backend supervisor path
--yes, -yConfirm deletion without prompting
--force, -fKill a running workspace before deleting
Terminal window
microagent delete research

Non-interactive cleanup:

Terminal window
microagent delete research --yes

Force-delete a running workspace:

Terminal window
microagent delete research --force

Lower-level form:

Terminal window
microagent delete agent-1 --state-dir /tmp/microagent