ariana-dot-dev/kimi-box-plugin/docker-sandbox

Docker sandbox (Box)

Use this when a task needs Docker: building an image, running docker compose, or testing a container. Many sandboxes (V8 isolates, restricted microVMs) can't run Docker at all — Box is a full VM with Docker preinstalled, so it just works.

Why Box

• Docker preinstalled, real machine — docker build, docker run, compose stacks.
• 75 GB disk — room for images and layers.
• Cheap & isolated — per-second billing, separate from the host.

Prereqs

curl -fsSL https://box.ascii.dev/install | sh (Windows: irm https://box.ascii.dev/install.ps1 | iex), then box login "$BOX_API_KEY" --json.

Recipe

box_id="$(box new --json | jq -r 'select(.event == "ready") | .id')"
box ssh "$box_id" -- bash -s < ./clone-and-build.sh   # git clone + docker build
box ssh "$box_id" -- "cd /project && docker compose up -d"
box ssh "$box_id" -- "host 8080"                       # expose the running container
box delete "$box_id" --json

Limits

EU-only; active-box cap scales by plan (100+); disk-level snapshots (containers don't survive stop/resume — restart compose after resume).