A computer for every agent. Pay only while it works.

import { Client } from "@taskcloud/sdk";
const client = new Client(); // reads TASKCLOUD_API_KEY

// A full VM that pauses itself after 5 idle minutes
const sbx = await client.sandboxes.create({
  template: "base", size: "default",
  auto_pause: { enabled: true, idle_timeout_seconds: 300 },
});

const run = await sbx.exec("npm ci && npm test");
console.log(run.exit_code, run.stdout);

await sbx.pause();  // RAM + disk snapshot, $0 compute
await sbx.resume(); // same processes, same PIDs

// 50 copies of the running VM, memory included (all or nothing)
const forks = await sbx.forkMany(50);

const port = await sbx.ports.expose({ port: 3000, visibility: "public" });
console.log(port.url); // https://<short_id>-3000.taskhost.cloud

from taskcloud import Client
client = Client()  # reads TASKCLOUD_API_KEY

# A full VM that pauses itself after 5 idle minutes
sbx = client.sandboxes.create(
    template="base", size="default",
    auto_pause={"enabled": True, "idle_timeout_seconds": 300},
)

run = sbx.exec("pip install -e . && pytest")
print(run.exit_code, run.stdout)

sbx.pause()   # RAM + disk snapshot, $0 compute
sbx.resume()  # same processes, same PIDs

# 50 copies of the running VM, memory included (all or nothing)
forks = sbx.fork_many(50)

port = sbx.ports.expose(3000, visibility="public")
print(port.url)  # https://<short_id>-3000.taskhost.cloud

# One static binary for macOS and Linux (see docs/cli)
taskcloud login                      # paste an API key

ID=$(taskcloud create --template base --size default -q)
taskcloud exec $ID -- npm ci '&&' npm test   # exit code = command's exit code

taskcloud pause $ID                   # $0 compute while paused
taskcloud resume $ID                  # RAM back, same PIDs

taskcloud fork $ID --count 50 -q        # prints 50 sandbox IDs
taskcloud port expose $ID 3000 --public # https://<short_id>-3000.taskhost.cloud
taskcloud ssh $ID                     # via ssh.taskhost.cloud

# Claude Code: give the agent its own VMs (local stdio server).
# During the beta @taskcloud/mcp is shared with participants; npm soon.
claude mcp add taskcloud --env TASKCLOUD_API_KEY=$TASKCLOUD_API_KEY -- npx -y @taskcloud/mcp

# Cursor, Claude Desktop and other clients: mcp.json
{
  "mcpServers": {
    "taskcloud": {
      "command": "npx",
      "args": ["-y", "@taskcloud/mcp"],
      "env": { "TASKCLOUD_API_KEY": "taskcloud_sk_..." }
    }
  }
}

# Tools: create_sandbox, exec, read_file, write_file, list_files,
# pause_sandbox, resume_sandbox, fork_sandbox, expose_port,
# desktop_stream_url, screenshot, computer_input, ...