Docs

Lab runs JavaScript in V8 isolates and saves a receipt for every run. Pick a thread below — read top-to-bottom or jump to what you need.

Start here

Get something running and read the receipt.

Install the client, run code, open the receipt URL.

Prove-it, self-heal, handoff, canary — receipts as the protocol.

Good fit vs poor fit. How it differs from a plain Worker.

How agents call Lab.

Endpoints, request bodies, curl examples.

@acoyfellow/lab — createLabClient and methods.

stdio MCP find + execute, or GET /lab/catalog.

The JSON shape at /results/:id.json.

The execution model in plain language.

Isolates, capabilities, chains, spawn, receipts.

What each capability does and how denials surface.

Worker Loaders, Effect, KV snapshot, spawn semantics.

How errors surface in receipts and which fields you can rely on.

Deploy and run Lab in production.

Deploy to your Cloudflare account with one bearer token.

Repo-enforced caps, chain depth, platform limits.

Untrusted guest code, capabilities, operator surface.

Common questions about agents, sandbox, receipts, edge.