Starstruk Logo MarkStarstruk

v0.3.3

superradcompany/microsandboxv0.3.3Mar 28, 2026by github-actions[bot]

AI Summary

v0.3.3 is a substantial release featuring volume management, guest mounts, and new CLI commands including `msb image` subcommands and `msb install/uninstall`. The release adds smoltcp user-space networking, OCI image config inheritance, guest user support, live metrics sampling, and registry authentication, while also refactoring the CLI by merging attach into shell and consolidating the supervisor into the VM process.

Key Highlights

  • Added volume management, guest mounts, and new CLI commands (msb image, msb install/uninstall)
  • Implemented smoltcp user-space networking stack for improved network handling
  • Added guest user support, live metrics sampling, and enhanced status command
  • Refactored CLI: merged attach into shell, simplified sandbox API, renamed Patch to replace
  • Added supervisor agent relay and merged supervisor into VM process for better cross-process sandbox access

Breaking Changes

  • CLI refactor: attach command merged into shell - users need to update scripts
  • Documentation rename: 'Patch' renamed to 'Replace' - may affect documentation references
  • Public API alignment with design docs - potential interface changes

New Features

  • Volume management and guest mounts
  • New CLI commands: msb image subcommands with DB persistence, msb install/uninstall
  • smoltcp user-space networking stack implementation
  • OCI image config inheritance and cross-layer overlay lookup fixes
  • Guest user support and guest hostname configuration
  • Live metrics sampling and enhanced status command
  • Registry authentication support
  • Background reaper for stale sandboxes
  • Rootfs patches, batch attach output, and I/O improvements
  • Loopback and /etc/hosts provisioning on every boot
  • IntoExecOptions/IntoAttachOptions traits for ergonomic exec and attach
  • O_SYMLINK fallback for symlink lookup on macOS
  • Environment merge fixes

Full Release Notes

## What's Changed
* feat: add volume management, guest mounts, and CLI commands by @appcypher in https://github.com/superradcompany/microsandbox/pull/435
* feat(sdk): align public API with design docs by @appcypher in https://github.com/superradcompany/microsandbox/pull/437
* docs: add Mintlify documentation site by @appcypher in https://github.com/superradcompany/microsandbox/pull/438
* refactor(cli): merge attach into shell and simplify sandbox API by @appcypher in https://github.com/superradcompany/microsandbox/pull/439
* feat(runtime): add supervisor agent relay for cross-process sandbox access (#440) by @appcypher in https://github.com/superradcompany/microsandbox/pull/440
* fix(cli): prevent ghost lines and stale progress in pull UI by @appcypher in https://github.com/superradcompany/microsandbox/pull/441
* feat(sdk): add IntoExecOptions/IntoAttachOptions traits for ergonomic exec and attach by @appcypher in https://github.com/superradcompany/microsandbox/pull/442
* feat(sandbox): inherit OCI image config and fix cross-layer overlay lookups (#443) by @appcypher in https://github.com/superradcompany/microsandbox/pull/443
* feat(cli): add `msb image` subcommands with DB persistence by @appcypher in https://github.com/superradcompany/microsandbox/pull/444
* feat(cli): add `msb install/uninstall` and sandbox reuse for named runs by @appcypher in https://github.com/superradcompany/microsandbox/pull/446
* feat(network): implement smoltcp user-space networking stack by @appcypher in https://github.com/superradcompany/microsandbox/pull/447
* refactor(runtime): merge supervisor into VM process by @appcypher in https://github.com/superradcompany/microsandbox/pull/448
* fix(filesystem): add O_SYMLINK fallback for symlink lookup on macOS by @appcypher in https://github.com/superradcompany/microsandbox/pull/450
* feat(sandbox): add rootfs patches, batch attach output, and improve I/O by @appcypher in https://github.com/superradcompany/microsandbox/pull/451
* feat(agentd): provision loopback and /etc/hosts on every boot by @appcypher in https://github.com/superradcompany/microsandbox/pull/452
* feat(sandbox): add background reaper for stale sandboxes by @appcypher in https://github.com/superradcompany/microsandbox/pull/453
* feat(docs,sandbox): rewrite docs and rename Patch overwrite to replace by @appcypher in https://github.com/superradcompany/microsandbox/pull/454
* feat(sandbox,cli): add guest user support and refactor CLI options by @appcypher in https://github.com/superradcompany/microsandbox/pull/456
* feat(sandbox,cli): add live metrics sampling and enhance status command by @appcypher in https://github.com/superradcompany/microsandbox/pull/457
* feat(cli,sandbox): add registry auth, guest hostname, and env merge fix by @appcypher in https://github.com/superradcompany/microsandbox/pull/458
* chore: bump workspace version to 0.3.3 by @appcypher in https://github.com/superradcompany/microsandbox/pull/459


**Full Changelog**: https://github.com/superradcompany/microsandbox/compare/v0.3.2...v0.3.3