Quickstart

export RUNTOOLS_API_KEY=rt_live_xxx

npm install -g @runtools-ai/cli
runtools --help

runtools login                          # interactive browser sign-in
runtools auth set-key "$RUNTOOLS_API_KEY"   # or store a key for scripts + CI

runtools auth whoami

runtools sandbox create --name my-first-sandbox --template base-ubuntu
runtools sandbox list

runtools sandbox get my-first-sandbox
runtools sandbox exec my-first-sandbox "echo Hello from Runtools"

runtools ssh-key add my-laptop --file ~/.ssh/id_ed25519.pub
runtools sandbox ssh my-first-sandbox

curl -X POST https://api.runtools.ai/v1/workspaces \
  -H "X-API-Key: $RUNTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Project","slug":"my-project"}'

runtools sandbox create \
  --name my-agent-sandbox \
  --template base-ubuntu \
  --mount 9b84ef42-9c3a-4930-9d4c-45c7f5c22d8e:/workspace

npm install @runtools-ai/sdk

import { RunTools } from '@runtools-ai/sdk';

const rt = new RunTools({ apiKey: process.env.RUNTOOLS_API_KEY });

const sandbox = await rt.sandbox.create({ name: 'sdk-demo', template: 'base-ubuntu' });
await sandbox.waitForReady();

const result = await sandbox.exec('pwd && ls -la', { cwd: '/workspace' });
console.log(result.stdout);

await sandbox.destroy();

runtools sandbox exec my-first-sandbox "nohup python3 -m http.server 3000 --bind 0.0.0.0 >/tmp/http.log 2>&1 &"
runtools sandbox url my-first-sandbox --port 3000 --open

runtools sandbox pause my-first-sandbox      # resume later with `sandbox resume`
runtools sandbox destroy my-first-sandbox --force