sand-sdk

The official TypeScript SDK for Sand.

npm install sand-sdk

import { Sand } from "sand-sdk";

const sand = new Sand(process.env.SAND_API_KEY!);

const sandbox = await sand.sandboxes.create({
  name: "agent-run",
  repository: "owner/repository",
});

await sand.sandboxes.waitForReady(sandbox.id);
const result = await sand.sandboxes.exec(sandbox.id, [
  "claude",
  "-p",
  "fix the failing tests, then commit your changes and push them to a new branch",
]);

console.log(result.stdout);
await sand.sandboxes.delete(sandbox.id);

Create an API key in the Sand console under API keys. The SDK is for server-side TypeScript/JavaScript.