{"slug":"sandbox-next","title":"sandbox-next","summary":"Build or maintain Cloudflare Sandbox apps on @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-migrate-to-next when porting a stable app.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-12T11:08:42.128808Z","repo":{"url":"https://github.com/fcakyon/claude-codex-settings","stars":1155,"forks":110,"license":"Apache-2.0","updatedAt":"2026-09-24T09:28:39Z"},"bodyHtml":"
\n

name: sandbox-next\ndescription: Build or maintain Cloudflare Sandbox apps on @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-migrate-to-next when porting a stable app.\nlicense: Apache-2.0

\n

Sandbox SDK — @next (1.0 preview)

\n

Isolated Linux environments on Cloudflare Containers, driven from Workers.

\n

Prefer preview docs and installed @next types over memory. APIs change; this skill is a gate, a contract, and a retrieval map—not a full manual.

\n

We recommend new projects on this line. Apps still on the default package use sandbox-stable. Port only when asked, via sandbox-migrate-to-next.

\n

1. Gate — confirm the package line

\n

Before writing code, inspect the app:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CheckMust match
npm dependency@cloudflare/sandbox@next (or another preview tag)
Container imageSame line (e.g. cloudflare/sandbox:next, next-python)
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
If you find…Action
Default @cloudflare/sandbox (no @next)Stop. Load sandbox-stable. Do not apply this skill’s APIs.
User wants to port stable → @nextStop. Load sandbox-migrate-to-next.
Self-deployed bridge onlyBridge is not on the 1.0 preview line yet. Keep bridge on stable package + image. Bridge (stable)
\n

Never mix an @next Worker package with a stable container image (or the reverse).

\n

Skills install: Agent setup · cloudflare/skills

\n

2. Contract — non-negotiables

\n\n

Minimal shape:

\n
import { getSandbox, proxyToSandbox, Sandbox } from \"@cloudflare/sandbox\";\n\nexport { Sandbox };\n\nconst sandbox = getSandbox(env.Sandbox, \"user-123\");\nconst process = await sandbox.exec([\"python3\", \"-c\", \"print(2 + 2)\"]);\nconst result = await process.output({ encoding: \"utf8\" });\n// result.stdout, result.exitCode\n
\n

Task-specific API documentation: references/api-quick-ref.md

\n

Examples index (next branch): references/examples.md

\n

3. Retrieve — open the doc for the task

\n

Fetch the page before implementing. Installed @next types win over guesses.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
You need to…Open
Orient / choose preview1.0 preview overview
First Worker, wrangler, DockerfileGet started
exec, handles, readiness, durabilityProcess execution
Process API signaturesProcesses API
Sandbox ID vs container vs sleep/destroyLifecycle
cwd / env / setEnvVarsEnvironment
Interactive PTY / browser terminalTerminals · Terminals API
Python/JS code interpreterInterpreter · Interpreter API
Extensions modelExtensions
Error classes and recoveryErrors · Errors API
Common failuresTroubleshooting
API hubAPI reference
Files, mounts, backups, ports, tunnels, proxyToSandboxMain docs for shared surfaces (ignore stable-only session/transport/sandbox.terminal): Files · Storage / mounts · Ports · Tunnels · Backups · Outbound traffic · Expose services · Production
Example appsexamples on next
Still on stable packagesandbox-stable · Main Sandbox docs
Porting an existing stable appsandbox-migrate-to-next · Migrate
\n

4. Before you ship

\n\n","files":[{"path":"references/api-quick-ref.md","sizeBytes":2456,"isText":true},{"path":"references/examples.md","sizeBytes":526,"isText":true},{"path":"SKILL.md","sizeBytes":6836,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-12T11:09:52.303112Z","sha256":"B56B9186929E226574C1709C274D04EB8F4FCD4F2D27EA3E414088D202D9B9A8","sizeBytes":4191},"review":null,"source":{"repositoryUrl":"https://github.com/fcakyon/claude-codex-settings","path":"plugins/cloudflare-skills/skills/sandbox-next","license":"Apache-2.0","commit":"8c25677efb55b473f7b0bbbb3658273ebc8eb993","subtreeSha":"A32AD53890294E51DE4F5FB953374B46CE8285D9BC233A87DD93E008C50350AE","lastSyncedAt":"2026-09-25T06:49:35.483925Z"},"reviewedAt":"2026-09-12T11:11:53.111925Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/cloudflare-skills/skills/sandbox-next"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fcakyon-claude-codex-settings@llmmart"},{"target":"git","command":"git clone https://github.com/fcakyon/claude-codex-settings.git"}]}