microagent

[ V0.1.30 — TOOLKIT FOR AGENTS IN MICROVMS ]

Isolated microVMs
for local AI agents.

A Go toolkit and CLI for running AI agents inside MicroVMs. Sandboxed by the kernel, orchestrated by code. Supports Firecracker and Apple Virtualization Framework backends.

brew install geoffbelknap/tap/microagent

Get started

(1) TRY IT FROM THE CLI

Run an agent workspace in seconds

Install once, then boot an isolated Linux microVM, run a command, and tear it down — all from the command line.

CLI quickstart

(2) BUILD WITH THE LIBRARY

Go orchestrator, or just microVMs

Drive microagent from a Go program. Boot, run, halt, resume, inspect — backend-neutral. Agent semantics or none.

Library quickstart

Browse the docs

(a) CONCEPTS

How the pieces fit

Architecture, backends, the boundary, networking, and how state and identity work across runs.

(b) CLI REFERENCE

Every command, every flag

run, create, start, halt, stop, kill, delete, status, ps, logs, connect, doctor, rootfs, kernel.

Exported package surface

vmkit, workspace, kernel, imagecache, rootfs, diagnostics, supervisors. CLI ↔ library mapping.

(d) SUPERVISOR PROTOCOL

Below the library

JSON request/response shape and the runtime contract supervisors implement.

(e) RECIPES

End-to-end examples

Simple agent, mediation channel, pin everything. Worked walkthroughs of common shapes.

(f) TROUBLESHOOTING

Common failure modes

Symptom-indexed guide for boot failures, kernel issues, networking, and supervisor errors.