Together Code Sandbox

Overview

Full VM sandboxes with Docker support, memory snapshots, and sub-3-second cloning. Powered by CodeSandbox infrastructure.

• SDK: npm install @codesandbox/sdk
• Auth: CodeSandbox API token from https://codesandbox.io/t/api
• Features: Docker/Dev Containers, filesystem persistence, browser connectivity

Quick Start

import { CodeSandbox } from "@codesandbox/sdk";

const sdk = new CodeSandbox(process.env.CSB_API_KEY!);

// Create a sandbox
const sandbox = await sdk.sandboxes.create();
const session = await sandbox.connect();

// Run commands
const output = await session.commands.run("echo 'Hello World'");
console.log(output); // Hello World

Sandbox Lifecycle

Templates

Create custom templates with pre-configured environments:

npx @codesandbox/sdk build ./my-template --ports 5173

Use templates when creating sandboxes:

const sandbox = await sdk.sandboxes.create({
  source: 'template',
  id: 'my-template-tag',
});

Browser Connectivity

Connect sandboxes to browser sessions:

// Server-side
const session = await sandbox.createBrowserSession({ id: req.session.username });

// Client-side
import { connectToSandbox } from '@codesandbox/sdk/browser';
const sandbox = await connectToSandbox({
  session: initialSessionFromServer,
  getSession: (id) => fetchJson(`/api/sandboxes/${id}`),
});
await sandbox.fs.writeTextFile('test.txt', 'Hello World');

VM Sizes & Pricing

Default recommendation: Nano for most workloads, Pico for simple code execution.

Concurrent VM Plans

• Build (free): 10 concurrent VMs
• Scale: 250 concurrent VMs ($170/mo base)
• Enterprise: Custom limits and credit discounts

Key Features

• Memory snapshots: Checkpoint and restore VM state
• Sub-3s cloning: Fork from templates instantly
• Docker support: Full Dev Container spec support
• FS persistence: Git version control on VM filesystem
• Auto-hibernate: Sandboxes hibernate when disconnected

Resources

• Official docs: Together Code Sandbox