Skip to content

v0.8.0

Latest

Choose a tag to compare

@geoffbelknap geoffbelknap released this 12 Jun 00:23
· 261 commits to main since this release
ddd98ac

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 spec model:) pairs a workspace with a local model: resolve, pull if missing, ensure a host runner, and bake MICROAGENT_MODEL_URL/OPENAI_BASE_URL into the guest env. The canonical ref persists in spec, manifest, and options.
  • start re-pairs from the manifest each boot; lifecycle verbs release the runner holder; supervise re-pairs before every supervised boot, including policy restarts.
  • Exposed on the MCP workspace.create tool.

Fixes

  • Companion processes no longer leak when a detached user-network guest exits on its own; delete refuses while recorded companions are alive.
  • Snapshot/pause/resume no longer drop runtime config fields (exec and shell work immediately after a snapshot).
  • create --setup keeps the OCI image env (including PATH) on later boots.
  • exec ws -- cmd -h runs the guest command instead of printing exec usage.
  • Guests get standard /dev/fd, /dev/stdin|stdout|stderr symlinks (fixes bash process substitution, e.g. the official postgres image).
  • Secret flags (--secret, --secrets-env-file, --secret-on-demand) work flag-after-name in create.

Breaking

  • serve mcp is 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.ResetGuestConfigCommand removed; rootfs BuildRequest gains ResetFinalConfig/FinalCommand/FinalMode, and FinalCommandAndMode reports the final command and mode.
  • Docs recipes/ moved to guides/; 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.