spawn/codesandbox
A be903f0089
feat: add CodeSandbox cloud provider (#857)
Add CodeSandbox as a new sandbox cloud provider for running AI agents.

CodeSandbox features:
- Firecracker microVMs with ~2 second start times
- SDK/CLI-based exec (no SSH)
- Free tier: 40 hours/month on Build plan
- Secure isolated environments

Implementation:
- Created codesandbox/lib/common.sh with SDK wrapper functions
- Implemented 3 agent scripts: claude, aider, openclaw
- Added CodeSandbox to manifest.json clouds
- Created matrix entries (3 implemented, 12 missing)
- Updated test/record.sh to list as non-recordable CLI cloud
- Added codesandbox/README.md with usage instructions

The implementation follows the existing pattern from e2b and modal,
using Node.js SDK (@codesandbox/sdk) for sandbox lifecycle management.

Agent: cloud-scout

Co-authored-by: B (Discovery Team) <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-13 02:09:31 -08:00
..
lib feat: add CodeSandbox cloud provider (#857) 2026-02-13 02:09:31 -08:00
aider.sh feat: add CodeSandbox cloud provider (#857) 2026-02-13 02:09:31 -08:00
claude.sh feat: add CodeSandbox cloud provider (#857) 2026-02-13 02:09:31 -08:00
openclaw.sh feat: add CodeSandbox cloud provider (#857) 2026-02-13 02:09:31 -08:00
README.md feat: add CodeSandbox cloud provider (#857) 2026-02-13 02:09:31 -08:00

CodeSandbox

CodeSandbox Firecracker microVMs via SDK/CLI. CodeSandbox

No SSH — uses CodeSandbox SDK/CLI for exec. Firecracker microVMs with ~2s start. Free tier: 40 hrs/mo on Build plan. Requires npm install -g @codesandbox/sdk.

Agents

Claude Code

bash <(curl -fsSL https://openrouter.ai/labs/spawn/codesandbox/claude.sh)

OpenClaw

bash <(curl -fsSL https://openrouter.ai/labs/spawn/codesandbox/openclaw.sh)

Aider

bash <(curl -fsSL https://openrouter.ai/labs/spawn/codesandbox/aider.sh)

Non-Interactive Mode

CODESANDBOX_SANDBOX_NAME=dev-mk1 \
CSB_API_KEY=csb_xxxxx \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  bash <(curl -fsSL https://openrouter.ai/labs/spawn/codesandbox/claude.sh)

Authentication

Get your CodeSandbox API key at: https://codesandbox.io/t/api

Enable all scopes when creating the key and export it as:

export CSB_API_KEY=your-key-here