Skip to content
Spinbox is experimental: APIs change and data may be lost. Status lists what is built and what proves it.

Evaluate Spinbox

View Markdown

Spinbox runs workspaces: virtual machines that a person or a program uses to run code, installed in your own AWS account. It was built as a place to work, and the same machine is a good place for code you don’t fully trust - an AI agent on a real repository, a dependency nobody has read - and for seeing what it changed and undoing it. What is Spinbox says what one is made of.

Each workspace is its own QEMU/KVM machine, with a kernel of its own, root, a persistent disk and SSH. A snapshot keeps a point to come back to, with the running processes if you ask; a diff between two snapshots lists the files added, modified or removed; a restore puts the disk, and the processes, back. A workspace’s network is closed until a policy opens it.

A small part runs all the time: the control plane and the proxy, two machines, and two Route 53 zones. Runners, the large spot machines workspaces run on, run while workspaces do and stop a while after, and are the largest cost. Cost lists each part with the setting that changes it, and what to put into the AWS Pricing Calculator.

Try it on one machine brings the development stack up on a single Linux host, with a real runner booting real virtual machines, from git clone to a command in a workspace. It is not an instant demo, and it is not an installation: nothing in it is backed up, and it answers only on localhost. The machine needs:

  • Linux on x86-64 with KVM (/dev/kvm, /dev/vhost-vsock and /dev/net/tun usable by you), and sudo without a password
  • Docker with the compose and buildx plugins
  • Go, Task, pnpm and mkcert
  • 30 GB free on the disk the checkout is on, and several minutes for the first run

Spinbox is experimental: APIs change and data may be lost. Before relying on it, three limits to know, each a row of Limitations:

Status lists every feature with what proves it, what is partly there, and what is not built. Security is the model, its mechanisms and its known gaps.

One OpenTofu module creates everything in your account and your region: Install on AWS says what it creates and the choices it makes for you, Before you start what you need, and Install the commands, in order. Then the Quickstart: sign in, create a workspace, snapshot, change something, see the diff, go back.

Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.