CLI reference

Command	Purpose
run	Boot an image and run a command, then tear down
create	Create a named, persistent workspace
start	Boot a stopped workspace
stop	Graceful shutdown
kill	Hard terminate
delete	Remove a workspace and its state
status	Show workspace state
ps	List workspaces
logs	Show boot/serial output
connect	Open the workspace console (Apple VF)
doctor	Check the host for backend support
rootfs	Build a rootfs from an OCI image
kernel	Install or verify a custom kernel
version	Print the version

Global flags

• --json — print JSON output
• --text — print human-readable output
• --output <json|text> — select output format
• --supervisor <path> — override the Apple VF supervisor path (MICROAGENT_APPLEVF_SUPERVISOR works too)

Output

All commands return structured output. With --json (or MICROAGENT_OUTPUT=json), the response matches the shape documented in the Apple VF supervisor protocol. Scripts should consume JSON; humans get the text format by default.