First release on the 0.8.x line: 0.8.x is the mature pre-1.0 development line (0.9.x is reserved for stabilization and 1.0 readiness). The jump from 0.1.46 changes no behavior. Promoted from v0.8.0-rc.1 with no product-code changes; the tag-gated live suites (Linux Firecracker full E2E on KVM, Windows Hyper-V parity smokes) ran green on the rc tag and re-run as automated gates on this tag.
Workspace model pairing
create --model(or specmodel:) pairs a workspace with a local model: resolve, pull if missing, ensure a host runner, and bakeMICROAGENT_MODEL_URL/OPENAI_BASE_URLinto the guest env. The canonical ref persists in spec, manifest, and options.startre-pairs from the manifest each boot; lifecycle verbs release the runner holder;supervisere-pairs before every supervised boot, including policy restarts.- Exposed on the MCP
workspace.createtool.
Fixes
- Companion processes no longer leak when a detached user-network guest exits on its own;
deleterefuses while recorded companions are alive. - Snapshot/pause/resume no longer drop runtime config fields (exec and shell work immediately after a snapshot).
create --setupkeeps the OCI image env (includingPATH) on later boots.exec ws -- cmd -hruns the guest command instead of printing exec usage.- Guests get standard
/dev/fd,/dev/stdin|stdout|stderrsymlinks (fixes bash process substitution, e.g. the official postgres image). - Secret flags (
--secret,--secrets-env-file,--secret-on-demand) work flag-after-name increate.
Breaking
serve mcpis no longer listed in CLI help (it is launched by MCP clients; interactive launch now prints client setup guidance). The command itself is unchanged.- Go library:
workspace.ResetGuestConfigCommandremoved; rootfsBuildRequestgainsResetFinalConfig/FinalCommand/FinalMode, andFinalCommandAndModereports the final command and mode. - Docs
recipes/moved toguides/; examples renamed body -> agent (minimal-agent*,agent.py).
Docs and install
- Docs site rewritten end to end: quickstart, coming-from-Docker, decision-first concepts, full CLI reference, six new task guides, first-agent tutorial.
- Local dev builds report
0.8.0-<sha>[-dirty]; source installs are friendlier.
Install: brew install geoffbelknap/tap/microagent — see CHANGELOG.md for full details.