メニュー
Migrate Cloudflare Sandbox SDK codebases away from features deprecated in June 2026 (HTTP and WebSocket transports, desktop, exposePort, default sessions, and stream-specific file and command APIs).
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | sandbox-2026-deprecation |
| description | Migrate Cloudflare Sandbox SDK codebases away from features deprecated in June 2026 (HTTP and WebSocket transports, desktop, exposePort, default sessions, and stream-specific file and command APIs). |
Use this skill when migrating a codebase that depends on the Cloudflare Sandbox SDK away from features deprecated in June 2026.
For the announcement, refer to the changelog entry. For detailed documentation, refer to the migration guide.
Update @cloudflare/sandbox and the sandbox container image before changing runtime configuration.
Search the codebase for deprecated configuration and APIs:
rg 'SANDBOX_TRANSPORT|transport:|exposePort\(|enableDefaultSession|execStream\(|readFileStream|writeFileStream'
Switch every sandbox to RPC transport with SANDBOX_TRANSPORT=rpc or getSandbox(..., { transport: "rpc" }).
Replace Sandbox SDK desktop APIs with Cloudflare Browser Run where browser automation is required.
Replace exposePort() with sandbox.tunnels.get(). Use quick tunnels for development and named tunnels for stable production hostnames.
Set enableDefaultSession: false on getSandbox().
Replace workflows that depend on persisted shell state with explicit sessions from sandbox.createSession().
Move stream-specific file and command logic to the base readFile(), writeFile(), and exec() APIs where streaming behavior is supported.
Deploy the Worker and smoke-test command execution, file operations, public URLs, and stateful session workflows.
| Deprecated feature | Replacement |
|---|---|
| HTTP or WebSocket transport | RPC transport |
| Sandbox SDK desktop | Cloudflare Browser Run |
exposePort() | sandbox.tunnels.get() |
| Default sessions | enableDefaultSession: false with explicit sessions |
| Stream-specific command and file helpers | Base command and file APIs with streaming support |
exposePort() blindly if the Worker uses proxyToSandbox() to inject authentication or rewrite responses. Preserve that behavior before moving traffic to tunnels.cd carrying across separate exec() calls, create an explicit session with cwd instead.Review the changed lines of a single file in a pull request for bugs, correctness, error handling, security, and maintainability, and return structured findings.
Review a pull request's title, description, and scope against the repository's PR conventions.
Reconcile raw specialist findings against the previous bot review and human PR comments to produce a final classified finding list.
Review changed MDX/docs files in a pull request against the Cloudflare docs style guide and return structured findings.
Use when contributing to the Cloudflare Docs repository — writing or editing documentation pages, choosing content types or components, adding changelog entries, reviewing docs, or learning how to contribute.
Creates and updates GitHub pull requests for cloudflare-docs changes. Load when asked to open, create, submit, update, or edit a PR, or write a PR title or description. Covers title conventions, branch naming, PR body structure, and the documentation checklist template.