# TaskCloud documentation

`TaskCloud` gives every AI agent its own persistent cloud computer. You pay only while it works.

> **Status:** private beta (waitlist). APIs may still change before general availability. Latency figures on these pages are **targets**, not guarantees.

## What a sandbox is

Each sandbox is a full **Firecracker microVM**, not a container:

- Its own Linux kernel, **Ubuntu 24.04**, root access, **systemd** and **Docker** inside.
- A **persistent disk** (50 GB included for the `default` size).
- Isolation per VM: Firecracker jailer, cgroups, and a separate network namespace.
- Runs in the **EU** on dedicated AMD Ryzen servers.

## What you can do with it

| Capability | Summary | Page |
| --- | --- | --- |
| Pause and resume | RAM and disk are snapshotted together. Processes, open windows and sessions survive. Resume target: p95 < 800 ms. | [Lifecycle](concepts/lifecycle.md) |
| Auto-pause and wake on request | Pauses after N minutes idle (default 5). An HTTP request, SSH connection or API call wakes it. Paused = $0 compute. | [Lifecycle](concepts/lifecycle.md) |
| Fork | Copy a running VM **including memory**. Target: < 2 s. | [Snapshots and fork](concepts/snapshots-and-fork.md) |
| Exec | Sync, background, SSE streaming, interactive PTY over WebSocket. 10+ concurrent commands per VM. | [Exec and files](guides/exec-and-files.md) |
| Files | Read, write, list, upload, download, watch. | [Exec and files](guides/exec-and-files.md) |
| Networking | Public HTTPS URL per port (`https://<short_id>-<port>.taskhost.cloud`), SSH through a gateway. | [Networking](guides/networking.md) |
| Desktop | Browser desktop streaming (KasmVNC, 1920x1080), signed links with TTL and read-only mode, screenshot + input API for computer use. | [Desktop and computer use](guides/desktop-and-computer-use.md) |
| Templates | Start from a snapshot or your own OCI/Docker image. | [Templates](concepts/templates.md) |
| Account | Scoped API keys, spend limits, signed webhooks, usage API. | [Security](security.md), [Webhooks](guides/webhooks.md), [Billing](billing.md) |
| Tooling | TypeScript and Python SDKs (typed by hand from the OpenAPI spec), CLI, MCP server, `llms.txt`. | [SDKs](sdk/typescript.md), [CLI](cli.md), [MCP](mcp.md) |

## Start here

1. [Quickstart](quickstart.md): first sandbox and first command in TypeScript, Python, CLI or curl.
2. [Sandboxes](concepts/sandboxes.md) and [Lifecycle](concepts/lifecycle.md): the mental model.
3. [API reference](api-reference.md): every endpoint, plus the [OpenAPI spec](https://api.task.cloud/v1/openapi.yaml).

## All pages

**Concepts**
- [Sandboxes](concepts/sandboxes.md)
- [Lifecycle and auto-pause](concepts/lifecycle.md)
- [Snapshots and fork](concepts/snapshots-and-fork.md)
- [Templates](concepts/templates.md)

**Guides**
- [Exec and files](guides/exec-and-files.md)
- [Networking: ports and SSH](guides/networking.md)
- [Desktop and computer use](guides/desktop-and-computer-use.md)
- [Webhooks](guides/webhooks.md)
- [Migrate from E2B](guides/migrate-from-e2b.md)
- [Migrate from boat.dev](guides/migrate-from-boat.md)

**Reference**
- [API reference](api-reference.md)
- [TypeScript SDK](sdk/typescript.md)
- [Python SDK](sdk/python.md)
- [CLI](cli.md)
- [MCP server](mcp.md)
- [Billing and pricing](billing.md)
- [Limits](limits.md)
- [Security](security.md)
- [llms.txt](llms.txt) (index for LLM agents)

## Not in the MVP

These are on the roadmap and are **not** available today: WebRTC desktop streaming at 60 fps, an AI-key proxy, a `full` VM class with nested KVM, GPUs, an open-source core with self-hosting, regions outside the EU, SSO and audit logs. We do not hold a SOC 2 report.