microagent ps

Last updated: 2026-07-30

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      linux-kvm    medium       user       on-failure

When no workspaces are running, 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 --output/--json.

Exit status

ps exits 0 when it produces the listing - an empty list is still a success - and follows the shared exit codes when the scan fails.

Related

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