spin-stack · workspaces you own
Workspaces for people. A sandbox for agents, as a side effect.
Every workspace is a virtual machine of its own, in your own AWS account, built from parts Linux and QEMU already have. Be root and break anything: a snapshot brings it back, running processes and all, a diff shows what changed, and the network stays closed until you open it. Built for people to work in, which is what makes it a good place for an agent too.
$ spin snapshot diff demo <after-id> --from <clean-id> --under /etc
- A/etc/greeting
- M/etc/hosts
- D/etc/issue
A separate machine reads the two and lists every file added, modified or removed.
Break it. See it. Undo it.
Section titled “Break it. See it. Undo it.”$ spin workspace create --name demo --wait $ spin snapshot create demo --description clean --with-memory --wait $ spin exec demo -- sh -c 'echo hello > /etc/greeting; rm /etc/issue; echo "# edited" >> /etc/hosts' $ spin snapshot create demo --description after --wait $ spin snapshot diff demo <after-id> --from <clean-id> --under /etc A /etc/greeting M /etc/hosts D /etc/issue $ spin workspace restore demo <clean-id> --with-memory $ spin workspace delete demo
$ spin workspace create --name demo --wait $ spin snapshot create demo --description clean --with-memory --wait $ spin exec demo -- sh -c 'echo hello > /etc/greeting; rm /etc/issue; echo "# edited" >> /etc/hosts' $ spin snapshot create demo --description after --wait $ spin snapshot diff demo <after-id> --from <clean-id> --under /etc A /etc/greeting M /etc/hosts D /etc/issue $ spin workspace restore demo <clean-id> --with-memory $ spin workspace delete demo
Three things it does
Section titled “Three things it does”Every workspace is a KVM virtual machine with its own kernel, root and a persistent disk. A person or an agent can install anything and break anything inside it. Around it, the QEMU process runs as a user of its own, opens nothing by name and has no network, and each machine sits in a network namespace of its own. What that boundary covers, and what it doesn’t yet, is in the security model.
e2e · TestAWorkspaceBootsARealGuestInspect: snapshot, diff, roll backA snapshot before, with the memory of the running processes. The files added, modified or removed between two snapshots, read by a separate machine. Restore, and the processes are running where they were.
e2e · TestADiffOfTwoSnapshotsNamesWhatWasAddedChangedAndRemovedControl: closed until you open itEgress is closed by default, and policies name what a workspace may reach. A team’s secret stays on the host’s proxy and never enters the workspace. All of it in your AWS account, where the logs stay too.
e2e · TestAWorkspaceNamedNoPolicyReachesNothing- Ready for agents. Claude Code and Codex on every workspace’s PATH, API keys with scopes, JSON output.
- Secrets the workspace never holds. A brokered rule adds the team’s secret on the way out, one for the person and one for the agent.
- Moves while it runs. A running workspace goes to another host with its processes as they are.
- Asleep when idle, awake as it was. A workspace nobody uses is suspended, after asking first, and a start resumes it.
- Reset in one command. A disk goes back to what it was created from, its snapshots kept.
- In your AWS account. One OpenTofu module installs it. There is no hosted version, so your code and your data stay in your account.
What’s built, and what isn’t
Section titled “What’s built, and what isn’t”96 features built, each with a test or a command that proves it, 83 of them with an end-to-end test, 2 not built yet and 17 limits, on the status page. An installation runs release v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea).
Straight answers
Section titled “Straight answers”- AWS only. One OpenTofu module installs Spinbox in your account. There is no hosted version.
- x86-64 only. Runners are x86-64 machines with nested virtualization.
- Linux guests only. A workspace boots the kernel Spinbox provides.
- No GPUs. A preset names the class of runner its workspaces run on, and no class hands a workspace a GPU.
- One region, one control plane. An installation lives in one AWS region.
Each answer is a limit row of the status page. The rest are on Limitations.
Workspaces you own, from the first snapshot.
What it is for, what it costs to run, how to try it on one machine, and how to install it.
Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.

