Skip to content
docs.microagent.sh

Install

Homebrew

Section titled “Homebrew”
Terminal window
brew install geoffbelknap/tap/microagent-kit

This installs the microagent CLI on Linux and macOS. On macOS it also installs microagent-applevf-supervisor, the Swift JSON executable that owns Apple Virtualization.framework lifecycle.

From source

Section titled “From source”

You need Go 1.26 or later. On macOS you also need a Swift toolchain to build the supervisor.

Terminal window
git clone https://github.com/geoffbelknap/microagent-kit.git
cd microagent-kit
go build ./cmd/microagent
swift build --package-path supervisors/applevf --disable-sandbox  # macOS only

To produce an ad-hoc signed supervisor (macOS):

Terminal window
make signed-supervisor

Verify the host

Section titled “Verify the host”
Terminal window
microagent doctor

doctor checks for the right backend on the current host: Firecracker plus /dev/kvm on Linux, Apple Virtualization.framework on macOS. It also reports default kernel status. Run it outside sandboxed environments on Linux so KVM visibility is honest.

Next

Section titled “Next”