Skip to content
Back to skills

Sandbox Ops

ASecurity

Run work on hosted cloud sandboxes without leaking boxes, losing work or credentials: boat.dev (boat, boat new, boat exec, bx_), E2B, Modal Sandboxes, Vercel Sandbox, Daytona, Fly Machines. Create and size a box, exec or ssh, copy files in and out, set the lifetime, delete and confirm it is gone, one API key per process. Covers remote agent lanes (fleetflow), one-time CI runners, heavy-job offload, Docker or DDEV on a box, residency. (Formerly boat-ops.) Not for writing @cloudflare/sandbox co...

  • 82 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgoshellbashdockergitapisecurity

Works with

  • claude code
  • cli
  • api

Security analysis

A100/100

Pro scans all 20 files and shows the line behind each finding

Scanned November 18, 2026

npx -y skills add 0xDarkMatter/claude-mods --skill sandbox-ops --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Sandbox Ops?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Sandbox Ops
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/0xdarkmatter-sandbox-ops/badge)](https://www.skillsdirectory.com/skills/0xdarkmatter-sandbox-ops)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: sandbox-ops
description: "Run work on hosted cloud sandboxes without leaking boxes, losing work or credentials: boat.dev (boat, boat new, boat exec, bx_), E2B, Modal Sandboxes, Vercel Sandbox, Daytona, Fly Machines. Create and size a box, exec or ssh, copy files in and out, set the lifetime, delete and confirm it is gone, one API key per process. Covers remote agent lanes (fleetflow), one-time CI runners, heavy-job offload, Docker or DDEV on a box, residency. (Formerly boat-ops.) Not for writing @cloudflare/sandbox code: use sandbox-stable or sandbox-next."
license: MIT
metadata:
  author: claude-mods
  related-skills: "fleet-ops, ci-cd-ops, docker-ops, ddev-ops, supply-chain-defense"
---

# sandbox-ops: hosted cloud sandboxes (boat.dev in depth)

A hosted sandbox is a Linux box you rent by the second, drive from a CLI or SDK, and
throw away. It is the right tool when the local machine is short of CPU or memory, when
a lane or CI job should run on clean Linux, or when the work must not touch the desk.
boat.dev is the provider in production use and gets the full profile (`references/boat-*.md`);
E2B, Modal, Vercel Sandbox, Daytona and Fly Machines get one card each. boat Facts
verified 2026-10-27 against its docs and `boat help`; each card states its own date, and
`scripts/check-sandbox-facts.py` re-checks them.

## Hard rules, any provider

1. **Set a lifetime above the job, and know what the end does.** Every provider has a
   default that ends a 1-4 h headless job: 5 min on E2B, Modal and Vercel, 15 min idle
   on Daytona, 1 h on boat, restart-forever on Fly. Know whether it kills, stops, pauses
   or erases. Table: [ttl-traps](references/ttl-traps.md).
2. **Delete only boxes you created, then confirm with two reads in the same scope** (same
   account, org and key as the create; from another scope a live box can look missing).
   `"<skill-dir>/scripts/confirm-gone.sh" --provider <p> <id>` does the reads.
3. **Hunt what outlives the box:** paused sandboxes, snapshots, volumes, stopped disks.
   Several never expire and keep billing ([ttl-traps](references/ttl-traps.md#what-outlives-the-box)).
4. **One key per process; never switch the machine login; nothing in argv; no
   credentials left on the box.** Put the key in the job's environment. Daytona needs
   `DAYTONA_API_URL` set too. [credentials-and-auth](references/credentials-and-auth.md).
5. **A box is readable by everything on it.** Assume root inside; no production data,
   no long-lived secrets. [security-and-residency](references/security-and-residency.md).
6. **Pin the CLI.** Self-updating CLIs (boat) break a 7-day supply-chain cooldown and
   change behaviour mid-run.
7. **Name boxes `<who>-<what>-<MMDD-HHMM>`** (`who` from `gh api user --jq .login`, UTC
   time): the name is the only owner a shared dashboard shows
   ([boat-lifecycle](references/boat-lifecycle.md#name-every-box)).

## On boat

- **`--no-update` on every `boat` call.** The CLI updates itself, at most every 6 hours,
  after a command ends [docs: cli-reference]. Never run `boat self-update`.
- **Create with `--no-env --no-snapshots --no-monitoring`.** `--no-env` keeps the
  account's stored secrets out; with `--no-snapshots` a stop erases it; without
  `--no-monitoring` boat keeps command history for 90 days [docs: data-retention]. The
  one exception, a golden base image with no client code:
  [boat-snapshots](references/boat-snapshots.md).
- **The TTL is a data-loss trap.** Auto-stop defaults to 1 hour [docs: limits], and exec
  and SSH do not extend it [docs: cli-reference]. `boat extend <id> --ttl <s>` SETS the
  time left from now; read `archiveAfter` in `boat info <id> --json` first so you never
  shorten a shared box.
- **`boat new --json` prints JSONL:** take the id from the `created` event, never
  `jq -r .id` (three lines; the delete fails and the box leaks).
- **`boat exec` does not forward stdin:** pipe data with `boat ssh <id> '<cmd>' < file`.
- **`BOAT_API_KEY` in the job's environment, never `boat login` for a second company:**
  the login is one machine-wide file under every shell. `boat status` shows whose wallet
  a create will bill. See [boat-security](references/boat-security.md#policy-and-accounts).
- **Exec children hold `CAP_DAC_READ_SEARCH`:** even a `chmod 000` directory is readable.

```bash
B="boat --no-update"
$B new --type default --ttl 3600 --no-env --no-snapshots --no-monitoring \
       --name "$who-myrepo-$(date -u +%m%d-%H%M)" --json > new.jsonl
id="$(jq -rs 'map(select(.event=="created"))[0].id' new.jsonl | tr -d '\r')"
$B exec "$id" --json --timeout 120 -- bash -c 'uname -a'      # waits; 600 s max
$B exec "$id" --detach -- bash -c 'make test > out.log 2>&1'  # long jobs: --status/--attach/--kill <pid>
$B ssh "$id" 'cat > in.tar' < in.tar                          # ssh forwards stdin; exec does not
$B delete "$id" --yes --json
bash "<skill-dir>/scripts/confirm-gone.sh" "$id"              # exit 0 = gone, 10 = still there
```

- One job end to end: `boat --no-update run --type default --push . -- <cmd>` creates,
  copies tracked files in, runs, deletes and exits with the command's code [cli].
- `--fail-fast` creates only if a machine is ready now (about 1.5 s, free when none is);
  `--setup-file` seeds a 64KB script at create.
- Sizes `small` / `default` / `large` / `xlarge` (2 to 16 vCPU), `default` $0.036 an
  hour; starts (12 a minute on the $20 plan) are the limit you hit first. Rates, limits,
  error codes: [boat-cost-and-limits](references/boat-cost-and-limits.md). Copy recipes,
  timings, Windows-host traps: [boat-lifecycle](references/boat-lifecycle.md).

## Providers

| Provider | Pick it for | Key variable | Default end | Worst trap | Card |
|---|---|---|---|---|---|
| boat.dev | cheapest by far; fleetflow driver exists | `BOAT_API_KEY` | auto-stop 1 h | a stop with snapshots off erases the box | `boat-*` refs |
| E2B | agent template, pause/resume with memory | `E2B_API_KEY` | kill at 5 min | paused sandboxes never expire | [e2b](references/e2b.md) |
| Modal | `au` region, env overrides the profile | `MODAL_TOKEN_ID` + `_SECRET` | 5 min | no SSH; region multiplier | [modal](references/modal.md) |
| Vercel Sandbox | `syd1`, credential injection | `VERCEL_TOKEN` (SDK) | 5 min, then snapshot | stop-snapshots pile up | [vercel](references/vercel.md) |
| Daytona | native SSH, Claude Code preinstalled | `DAYTONA_API_KEY` + `_URL` | stop at 15 min idle | 10 GB disk; key ignored without URL | [daytona](references/daytona.md) |
| Fly Machines | cheap Australian VM, plain SSH | `FLY_API_TOKEN` | restart `always` | rootfs and volumes bill when stopped | [fly](references/fly.md) |

Writing code against Cloudflare's `@cloudflare/sandbox` SDK is a platform build, not a
hosted box: use `sandbox-stable` or `sandbox-next`. The verbs every provider must offer,
side by side: [lifecycle-contract](references/lifecycle-contract.md).

## What to use a box for

| Use | Start here |
|---|---|
| A fleetflow lane on a remote boat box, lanes per box, Codex on a box | [boat-fleetflow-lanes](references/boat-fleetflow-lanes.md) |
| Offload a heavy gate, render or test fan-out | [boat-fleetflow-lanes](references/boat-fleetflow-lanes.md#heavy-job-offload) |
| A one-time GitHub Actions runner, with fallback to GitHub's runner | [boat-ci-runner](references/boat-ci-runner.md) |
| Docker builds or DDEV on a box | [boat-docker-ddev](references/boat-docker-ddev.md) |
| WebSearch/WebFetch missing on a remote lane | [boat-fleetflow-lanes](references/boat-fleetflow-lanes.md#web-tools-on-lanes) |
| Can this code or data go on a box? Where does it run? | [security-and-residency](references/security-and-residency.md), [boat-security](references/boat-security.md) |
| A lane or runner on another provider | its card, then [lifecycle-contract](references/lifecycle-contract.md) |

## Landmines

| Landmine | What happens | Do instead |
|---|---|---|
| A provider's default timeout | the job dies at 5-15 min, or a Fly job restarts forever | set the lifetime at create; read it back |
| Confirming from another account or org | a live box looks gone | confirm in the create's scope |
| A paused, stopped or snapshotted leftover | bills for weeks; E2B paused boxes never expire | list them after every run |
| A key in a flag (`--token`, `--api-key`) | readable in the process list and shell history | the provider's env variable |
| `DAYTONA_API_KEY` alone | the CLI runs under the saved profile's account | set `DAYTONA_API_URL` too |
| `exec --timeout` above 600 s (or 0) on boat | output switches to a live stream; JSON callers break [cli] | 600 s or less; `--detach` for long jobs |
| boat waiting-command output cap | 8 MiB per stream [docs: limits] | chunk big downloads, or use `ssh` |
| boat non-zero remote exit | the CLI exits 1, hiding the real code [driver] | read `exitCode` from `--json`, or a `__rc=$?` sentinel |
| boat `CAP_DAC_READ_SEARCH` | permission tests fail; Codex's bwrap refuses to start [field] | `setpriv --inh-caps=-all --ambient-caps=-all --` |
| Repo denies WebFetch/WebSearch by bare name | the tool vanishes from a lane [field] | fleetflow's refusal or `FLEETFLOW_REMOTE_WEB_LIFT=1` |
| fleetflow lane ids over 10 characters | the Bash sandbox fails to start on the box (socket path limit) | ids of 10 characters or fewer |
| A boat key made on the dashboard | scoped to a personal account; an `org` create gave 403 `not_org_member` [field] | `GET /api/v1/orgs` once before wiring a key into CI |
| boat REST delete without `X-Ascii-Confirm-Delete` | 409, and the box keeps billing [field] | send the header; retry 409, 429, 5xx |
| An outage during cleanup | a delete lost to it is never re-sent [field] | retry with backoff; an outage ends in exit 7, never a pass |
| Auto mode | refuses steps that put a credential on a third-party VM [driver] | a permission rule for the exact command |
| Parallel workers on a fresh box | race on a first model or package download [field] | a one-worker warm-up pass first |

Windows-host traps (`scp` paths, Git Bash rewriting, `jq.exe` CRLF) are in
[boat-lifecycle](references/boat-lifecycle.md#driving-boat-from-a-windows-host).

## Scripts

- **`check-sandbox-facts.py --provider boat|e2b|modal|vercel|daytona|fly|all`**: the
  staleness verifier (SKILL-RESOURCE-PROTOCOL section 7) for `assets/facts-boat.json` and
  `assets/facts-providers.json`. `--offline` (PR CI): the prose still states every fact
  and flag, and each verified date matches. `--live` (weekly): each fact against its docs
  page, and boat's flags against `boat --no-update help` where installed. Exit 10 drift,
  7 a page unreachable or reshaped (advisory), 0 current.
- **`confirm-gone.sh [--provider boat|e2b|vercel|daytona|fly] <id>...`**: read-only.
  boat: polls `info` until `not_found`, then checks `list --all`; others: the id must be
  absent from the provider's list. Prints `id<TAB>gone|present`; exit 0 all gone, 10 some
  still there, 7 provider unreachable, 5 no CLI or jq. It never deletes.

## Related skills

- `fleet-ops` lands the branches remote lanes bring home; fleetflow (its own repo) owns
  the remote-lane runtime in [boat-fleetflow-lanes](references/boat-fleetflow-lanes.md).
- `ci-cd-ops` for GitHub Actions in general; `docker-ops` and `ddev-ops` for the tools.
- `supply-chain-defense` for the 7-day cooldown that pinning the CLI protects.
- `sandbox-stable` / `sandbox-next` (Cloudflare's) for `@cloudflare/sandbox` code.

## Sources

- **[docs]** each provider's docs: boat's read 2026-10-27, the others 2026-11-05 (URLs
  in the cards). **[cli]** `boat help <command>`, 2026-10-27.
- **[driver]** fleetflow's host driver `scripts/hosts/boat.sh`; **[bench]** its
  sandbox-bench runs, 2026-10-22.
- **[field]** field reports 2026-10-23 to 11-05: Codex sandbox reports, a CI runner
  trial, Docker benchmarks, DDEV on a box, heavy-job offload, a REST teardown review and
  a per-process `BOAT_API_KEY` test.
- **[report]** the 2026-11-05 provider research behind the cards.

Files in this skill

  • SKILL.md11.8 KB
  • assets/facts-boat.json3.8 KB
  • assets/facts-providers.json8.5 KB
  • references/boat-ci-runner.md7.6 KB
  • references/boat-cost-and-limits.md4 KB
  • references/boat-docker-ddev.md3.3 KB
  • references/boat-fleetflow-lanes.md5.7 KB
  • references/boat-lifecycle.md9.7 KB
  • references/boat-security.md6.8 KB
  • references/boat-snapshots.md2.7 KB
  • references/credentials-and-auth.md2.7 KB
  • references/daytona.md3.9 KB
  • references/e2b.md4.5 KB
  • references/fly.md3.3 KB
  • references/lifecycle-contract.md2.7 KB
  • references/modal.md3.4 KB
  • references/security-and-residency.md3.1 KB
  • references/ttl-traps.md2.6 KB
  • references/vercel.md4.1 KB
  • scripts/check-sandbox-facts.py20.4 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.