Cloudflare Computer
github.com/cloudflare/computer- Category
- Developer Tools
- Rank
- No. 1527Tools index
- Pricing
- Open Source
- Platform
- cli · web
- Type
- TOOL
- Builder
- cloudflare
- GitHub
- 9.2k stars
- Latest release
- @cloudflare/computer@0.3.1
- Date
About
A virtual filesystem for AI agents that lives inside a Durable Object, backed by SQLite, exposing a pluggable execution surface with three backends: a full-Linux sandbox container, an isolated shell (just-bash) running in a Cloudflare Worker, and an isolated JavaScript runtime. It gives agents a persistent, syncable computer-like environment to run shell commands or code without a separate storage layer.
What it does
Cloudflare Computer gives an AI agent a durable working directory plus a choice of execution environments. The agent can manipulate files, run shell commands or JavaScript, use workspace-aware Git operations, and publish generated assets. Callers choose a full Linux container when real binaries matter, or lighter Worker isolates for shell and module execution. Multiple execution backends can share one workspace and connect only when first used.
Why it's ranked here
The architecture solves a real agent problem: files, execution, synchronization, and Git share one coherent workspace instead of requiring separate adapters. The common execution surface lets applications compare or switch runtimes without rebuilding the surrounding workflow. Runnable examples cover HTTP, MCP, chat agents, egress policy, artifact publishing, and asset sharing. The preview warning is decisive, though. This is compelling infrastructure for experiments, not a production dependency yet.
What's good
Backend choice is unusually practical. Full Linux supports real binaries and network access, while Worker isolates offer lighter shell or JavaScript execution. The shell isolate reads the authoritative workspace directly, avoiding a second store and synchronization delay. Container synchronization commits incoming batches transactionally. Built-in Git covers common repository operations, and asset sharing streams files to R2 without buffering the body. Backends also load lazily.
Tradeoffs
The maintainers explicitly call the package preview-only, with unstable APIs and a design that may change. The design specification describes future intent, not necessarily current behavior. Container execution adds a daemon, FUSE mount, RPC channel, and synchronization loop. Benchmarks report strong metadata performance but weaker large sequential I/O than disk. Asset sharing requires the Cloudflare Workers runtime, R2 credentials, and an R2 bucket.
How to use it well
Use it for Cloudflare-based agent prototypes that need a persistent work area across tool calls, especially workflows mixing file edits, Git, shell commands, JavaScript modules, generated artifacts, or shareable assets. Start with a Worker isolate when its command set is enough, then select the container for native binaries or full Linux behavior. Treat egress policy as an explicit design choice. It does not cover production stability guarantees or general deployment outside the documented Cloudflare environment.
Technical notes+
packages/computer/src/index.ts exposes the top-level Worker and Durable Object library, with backend implementations split into subpath entries for tree-shaking. packages/dofs/src/index.ts provides the SQLite-backed filesystem and sync primitives, while packages/dofs/src/schema/index.ts initializes versioned schema state transactionally. packages/rpc/src/server.ts implements capnweb sync and shell servers over WebSocket and HTTP batch carriers, including transactional batch application and change streaming. packages/computerd/src/fuse/index.ts and packages/computerd/src/exec/index.ts expose the container mount and process runner. packages/computer/src/git/cli.ts supplies a Git-shaped dispatcher, and packages/computer/src/tools/index.ts exports AI-facing file, execution, and publishing tools.
Observed
- License
- MIT
- Primary language
- TypeScript across the presented package source files
- Packaging
- Private npm workspace monorepo with installable @cloudflare/computer package
- Library interface
- Typed library surfaces for filesystem, runtime, Git, mounts, assets, and AI tools
- MCP interface
- Repository includes an MCP example with one Code Mode tool backed by a durable workspace
- HTTP interface
- Runnable examples expose write, read, and execution operations over HTTP
- Platform support
- Runs in Cloudflare Workers and Durable Objects, with a Linux x64 container artifact
- Runtime choices
- Ships container, Worker shell, and Worker JavaScript execution backends
Read from README.md, package.json, packages/rpc/src/index.ts, packages/dofs/src/index.ts, packages/rpc/src/server.ts, packages/computer/src/index.ts, packages/computer/src/git/cli.ts, packages/dofs/src/schema/index.ts, packages/computer/src/git/index.ts, packages/computer/src/tools/index.ts, packages/computerd/src/exec/index.ts, packages/computerd/src/fuse/index.ts, packages/computerd/src/shim/index.ts, packages/computer/src/assets/index.ts, packages/computer/src/mounts/index.ts.
What it can do
Execute shell commands in an isolated shell backend
Shell command → Command output
Run code in an isolated JavaScript runtime
JavaScript code → Execution result
Run commands or code inside a full-Linux sandboxed container
Shell command or code → Execution result
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.