Skip to content
cccskills
FreePublished on GitHub

sandbox-2026-deprecation

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).

The English summary is being prepared. Showing the original description.

try-works/role-model117 stars(GitHub 117 + cccskills 0)
Works withCloudflare

Run score Not tested

See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Sandbox SDK 2026 deprecation migration

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.

Migration checklist

  1. Update @cloudflare/sandbox and the sandbox container image before changing runtime configuration.

  2. Search the codebase for deprecated configuration and APIs:

    rg 'SANDBOX_TRANSPORT|transport:|exposePort\(|enableDefaultSession|execStream\(|readFileStream|writeFileStream'

  3. Switch every sandbox to RPC transport with SANDBOX_TRANSPORT=rpc or getSandbox(..., { transport: "rpc" }).

  4. Replace Sandbox SDK desktop APIs with Cloudflare Browser Run where browser automation is required.

  5. Replace exposePort() with sandbox.tunnels.get(). Use quick tunnels for development and named tunnels for stable production hostnames.

  6. Set enableDefaultSession: false on getSandbox().

  7. Replace workflows that depend on persisted shell state with explicit sessions from sandbox.createSession().

  8. Move stream-specific file and command logic to the base readFile(), writeFile(), and exec() APIs where streaming behavior is supported.

  9. Deploy the Worker and smoke-test command execution, file operations, public URLs, and stateful session workflows.

API replacements

Deprecated featureReplacement
HTTP or WebSocket transportRPC transport
Sandbox SDK desktopCloudflare Browser Run
exposePort()sandbox.tunnels.get()
Default sessionsenableDefaultSession: false with explicit sessions
Stream-specific command and file helpersBase command and file APIs with streaming support

Notes for agents

  • Do not remove exposePort() blindly if the Worker uses proxyToSandbox() to inject authentication or rewrite responses. Preserve that behavior before moving traffic to tunnels.
  • If code relies on cd carrying across separate exec() calls, create an explicit session with cwd instead.
  • Tunnels require RPC transport. Configure RPC before migrating public URLs.
  • Large or binary file streaming requires RPC transport.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agents-sdk

Free

Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, chat applications, voice agents, or browser automation. Covers Agent class, state management, callable RPC, Workflows, durable execution, queues, retries, observability, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

The English summary is being prepared. Showing the original description.

try-works/role-model117Updated Oct 25, 2026

cloudflare

Free

Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

The English summary is being prepared. Showing the original description.

try-works/role-model117Updated Oct 25, 2026

cloudflare-email-service

Free

Send and receive transactional emails with Cloudflare Email Service (Email Sending + Email Routing). Use when building email sending (Workers binding or REST API), email routing, Agents SDK email handling, or integrating email into any app — Workers, Node.js, Python, Go, etc. Also use for email deliverability, SPF/DKIM/DMARC, wrangler email setup, MCP email tools, or when a coding agent needs to send emails. Even for simple requests like "add email to my Worker" — this skill has critical config details.

The English summary is being prepared. Showing the original description.

try-works/role-model117Updated Oct 25, 2026

cloudflare-one

Free

Guides Cloudflare One Zero Trust and SASE work across Access, Gateway, WARP, Tunnel, Cloudflare WAN, DLP, CASB, device posture, and identity. Use when designing, configuring, troubleshooting, or reviewing Cloudflare One deployments. Retrieval-first: use current Cloudflare docs/API schemas instead of embedded product docs.

The English summary is being prepared. Showing the original description.

try-works/role-model117Updated Oct 25, 2026

cloudflare-one-migrations

Free

Plans migrations from Zscaler ZIA/ZPA, Palo Alto, legacy VPN, SWG, or SASE stacks to Cloudflare One. Use for migration assessments, policy mapping, rollout plans, and parity/gap analysis.

The English summary is being prepared. Showing the original description.

try-works/role-model117Updated Oct 25, 2026

code-review

Free

Review the changed lines of a single file in a pull request for bugs, correctness, error handling, security, and maintainability, and return structured findings.

The English summary is being prepared. Showing the original description.

try-works/role-model117Updated Oct 25, 2026

See all skills by try-works

Report a problem with this skill