Documentation
Everything you need to run JavaScript in Cloudflare isolates. From quick starts to deep dives on architecture and the HTTP API.
Quick Start
Guides
Self-Hosting
Deploy the public app, private Worker, and backing Cloudflare resources.
HTTP API
Run modes, endpoints, curl, request/response shapes.
Agents
stdio MCP find + execute, or GET /lab/catalog + HTTP runs.
FAQ
Agents, sandbox, saved results, limits, why edge — for AI-curious SWEs.
TypeScript Client
@acoyfellow/lab — install, createLabClient, methods.
Agent Patterns
Prove it, self-heal, handoff, canary — saved results as the protocol.
When to use Lab
Good fit vs poor fit; relationship to plain Workers.
Reference
Architecture
Worker loaders, Effect, KV snapshot, spawn, chains.
Capabilities
Registry-backed capability IDs, denied errors, and runtime semantics.
Saved Result Schema
Saved-result JSON, viewer semantics, and `resultId`.
Limits
Repo-enforced caps, chains, R2 invoke, platform limits.
Security model
Untrusted guest code, capabilities, operators.
Failures & step data
Chain errors, partial-or-empty step data on failure, isolate reasons.