microagent doctor
microagent doctor [--backend <name>] [--arch <arch>] [--supervisor <path>]doctor reports host support for the active backend and the default kernel
status. Run it first when something isn’t working.
What it checks
Section titled “What it checks”- Apple VF (macOS): Virtualization.framework available, supervisor reachable, default kernel installed.
- Firecracker (Linux):
firecrackerbinary on PATH (orMICROAGENT_FIRECRACKER),/dev/kvmpresent,/dev/vhost-vsockpresent, default kernel installed.
On Linux, run microagent doctor outside sandboxed agent environments so KVM
visibility is honest.
| Flag | Description |
|---|---|
--backend <name> | Backend override (apple-vf or firecracker) |
--arch <arch> | Guest architecture (amd64, arm64) |
--supervisor <path> | Override the Apple VF supervisor path |
--json | Print structured JSON output |
Example
Section titled “Example”microagent doctormicroagent doctor --json