Skip to content

microagent host

microagent host [--arch <arch>] [--supervisor <path>]

host reports what microagent can see on the current machine: backend, architecture, supervisor availability, kernel status, virtualization support, vsock support, and console mode. It uses the same probes as doctor, but is meant as an inspectable capability report.

FlagDescription
--backend <name>Backend override (apple-vf, firecracker, or windows-hyperv)
--arch <arch>Guest architecture (amd64, arm64)
--supervisor <path>Override the installed host backend supervisor path
--jsonGlobal flag before host; print structured JSON output
BackendConsole
Apple VFinteractive via connect
Firecrackerinteractive via connect; captured output via logs
Windows Hyper-Vhvsock via connect; captured output via logs

consoleAvailable reports backend capability on this host. A workspace can still reject connect until it is running and the backend has created the runtime console input endpoint.

Terminal window
microagent host
microagent --json host