SDK & CLI

Corevelos ships three ways to drive sandboxes, all on the same REST API.

TypeScript SDKCopy Anchor Link

npm i @corevelos/sdk

import { Sandbox } from "@corevelos/sdk";

const box = await Sandbox.create({ template: "base" });
await box.commands.run("echo hello");
await box.kill();

Python SDKCopy Anchor Link

The Python SDK mirrors the TypeScript surface one-to-one.

pip install corevelos

from corevelos import Sandbox

box = Sandbox.create(template="base")
box.commands.run("echo hello")
box.kill()

CLICopy Anchor Link

A zero-dependency CLI for the shell and CI:

npx @corevelos/cli sandbox create --template base
npx @corevelos/cli sandbox exec <id> -- "python -c 'print(1)'"
npx @corevelos/cli sandbox ls

Authenticate once with COREVELOS_API_KEY, or corevelos login.

MCP serverCopy Anchor Link

Agent clients that speak the Model Context Protocol — Claude, Cursor and others — can create and drive sandboxes natively. Point the client at the Corevelos MCP server and give it your API key; the agent gets create, run, files and kill as tools.