microagent ps

Last updated: 2026-06-23

microagent ps [--state-dir <dir>]

ps prints the live workspace view: workspaces whose VM state is starting, running, paused, quarantined, or stopping. It does not show stopped persistent workspaces. Use list for the full saved-workspace inventory.

Examples

Show running workspaces:

microagent ps
microagent --json ps

Text output uses the same columns as list:

NAME                     STATE        BACKEND      PROFILE      NETWORK    RESTART
research                 running      firecracker  medium       user       on-failure

When no VMs are live, the text output is:

No workspaces.

With --json, the rows are returned under workspaces.

Flags

Flag	Description
--state-dir <dir>	State directory to scan (default ~/.microagent/)
--json	Global flag before ps; print structured JSON output

See global flags for --json/--text/--output/--mode.

Related

• list - full saved-workspace inventory
• status - detailed state for one workspace