Code Execution (CSB SDK)

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

// Create the client with your token
const sdk = new CodeSandbox(token);

// This creates a new sandbox by forking our default template sandbox.
// You can also pass in other template ids, or create your own template to fork from.
const sandbox = await sdk.sandbox.create();

// You can run JS code directly
await sandbox.shells.js.run("console.log(1+1)");
// Or Python code (if it's installed in the template)
await sandbox.shells.python.run("print(1+1)");

// Or anything else
await sandbox.shells.run("echo 'Hello, world!'");

// We have a FS API to interact with the filesystem
await sandbox.fs.writeTextFile("./hello.txt", "world");

// And you can clone sandboxes! This does not only clone the filesystem, processes that are running in the original sandbox will also be cloned!
const sandbox2 = await sandbox.fork();

// Check that the file is still there
await sandbox2.fs.readTextFile("./hello.txt");

// You can also get the opened ports, with the URL to access those
console.log(sandbox2.ports.getOpenedPorts());

// Getting metrics...
const metrics = await sandbox2.getMetrics();
console.log(
  `Memory: ${metrics.memory.usedKiB} KiB / ${metrics.memory.totalKiB} KiB`
);
console.log(`CPU: ${(metrics.cpu.used / metrics.cpu.cores) * 100}%`);

// Finally, you can hibernate a sandbox. This will snapshot the sandbox and stop it. Next time you start the sandbox, it will continue where it left off, as we created a memory snapshot.
await sandbox.hibernate();
await sandbox2.hibernate();

// Open the sandbox again
const resumedSandbox = await sdk.sandbox.open(sandbox.id);