Repository navigation
mocactl v0.7.0 — the sandbox service (sbx)
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 --applybrings 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
exitskip the pre-teardownsync, 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
/workloadsphase-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 | shInstalls 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