Skip to content

mocactl v0.7.0 — the sandbox service (sbx)

Choose a tag to compare

@pdettori pdettori released this 21 Oct 01:25
0e33a17

mocactl v0.7.0 — the sandbox service (sbx)

The headline is mocactl sbx: the client for SBX0, the internal sandbox service —
per-Exec Firecracker microVMs behind a relay in their own namespace, reached with
per-sandbox tokens minted by a control-plane sandbox profile. SBX0's design and ADR
are Accepted as of this release, with the live acceptance recorded in
docs/sbx/security-review.md.

mocactl sbx

  • login — the GitHub device flow against the control plane; subjects are allowlisted.
  • templates / create / ls / rm / token / env — the sandbox lifecycle. Tokens
    are Ed25519, scoped to one sandbox and workspace, 15 minutes by default; a sandbox is
    reachable only by its owner (everyone else gets a 404).
  • run / put — run a command (or a script on stdin) in /workspace, write a file
    from stdin; every Exec gets a fresh VM that is destroyed after.
  • mcp — a stdio MCP server exposing the sandbox to coding agents.
  • up / pull [--apply] — in a git repository: create or reuse its sandbox, push the
    working tree, bind it in .sbx/, and point Claude Code and OpenCode at the sandbox's
    MCP tools with their local tools denied; pull --apply brings the agent's changes back,
    refusing to touch local agent config or hooks.
  • doctor — one line on what would break a session here.

The user guide has the
cohort-facing walkthrough; the
design spec
and ADR-0042
have the why.

Fixes in the deployed service

  • Write durability (#562): a Firecracker command wrapper let a command ending in
    exit skip the pre-teardown sync, so every client write made through that path
    (sbx put, edit, the MCP write tools) was silently lost when the VM was destroyed.
    Caught by the live acceptance; fixed with a regression test and a strengthened KVM
    durability gate.
  • The live smoke's headless Claude step needed the sandbox MCP allow on the CLI (#564) —
    smoke tooling only, no service change.

Also in this release

  • Audit decisions are logged as structured JSON, carrying subject and sessionId (#563).
  • The /workloads phase-2 design: per-workload sandboxes and storage via a separate
    moca-provisioner (#553).
  • Dependency bumps (marked, react, codeql-action) and the usual review-hardening fixes
    across the SBX0 stack (#547, #550, #554).

Installing

curl -fsSL https://raw.githubusercontent.com/rossoctl/moca/main/scripts/install-mocactl.sh | sh

Installs the latest release (this one). The mocactl-edge prerelease tracks every push to
main; its bundle has been identical to this release's since the SBX0 acceptance merge.

Full Changelog: v0.6.1...v0.7.0