gitwtfhub

wtf is computer?

cloudflare/computer — explained in plain English

Analysis updated 2026-08-13

7,922TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

TL;DR

Cloudflare Computer gives an AI agent a virtual filesystem and pluggable sandboxed runtimes to read, write, and execute code in.

Mindmap

mindmap
  root((Cloudflare Computer))
    What it does
      Virtual filesystem
      Agent sandboxing
      Multiple runtimes
    Tech stack
      TypeScript
      Durable Objects
      SQLite
      FUSE
    Use cases
      Agent code execution
      Container sandboxes
      MCP tools
    Audience
      Developers
      AI agent builders
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Give an AI agent a sandboxed Linux environment to run real commands and binaries in.

REASON 2

Build an agent tool that reads and writes files through a durable, synced virtual filesystem.

REASON 3

Run untrusted JavaScript or shell code from an agent inside an isolated Cloudflare Worker.

REASON 4

Compare agent performance across container, shell, and JavaScript execution backends.

What's in the stack?

TypeScriptCloudflare WorkersDurable ObjectsSQLiteFUSE

How it stacks up

cloudflare/computercloudflare/cloudflare-ostwbs/icons
Stars7,9228,0038,009
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderateeasy
Complexity4/54/51/5
Audiencedeveloperdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Preview-only package with unstable APIs, not suitable for production use.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Cloudflare Computer gives an AI agent something like its own virtual computer to work in. At its core is a virtual filesystem that lives inside a Durable Object, a type of Cloudflare storage that keeps authoritative state in SQLite, and this filesystem can be plugged into different ways of actually running code. Three execution backends ship today. The Container backend projects the filesystem into a real sandboxed Linux environment with real binaries and network access, mounted through a component called computerd. The Isolate shell backend runs a lightweight shell tool called just-bash directly inside a Cloudflare Worker, without needing a separate sync step. The Isolate JavaScript backend runs actual JavaScript modules in a fresh Worker, with access to the same filesystem through familiar Node-style file APIs. The project ships with a large set of runnable examples, showing an agent writing files and running commands in a container, an MCP tool backed by the workspace, a chat agent using the workspace as a working directory, and a tutorial that walks through building an agent that writes a markdown file and converts it to a PDF. The maintainers are explicit that this is a preview release only. The APIs are unstable and the design may change, so it is meant for experiments and prototypes rather than production systems. It is written in TypeScript, structured as a small monorepo of packages, and released under the MIT license.

Yoink these prompts

Prompt 1
Help me install @cloudflare/computer and set up a basic filesystem-backed workspace.
Prompt 2
Walk me through the examples/container example that mounts computerd inside a sandbox.
Prompt 3
Explain the difference between the Container, Isolate shell, and Isolate JavaScript backends.
Prompt 4
Show me how to build an MCP tool on top of Cloudflare Computer's workspace.

Frequently asked questions

wtf is computer?

Cloudflare Computer gives an AI agent a virtual filesystem and pluggable sandboxed runtimes to read, write, and execute code in.

What language is computer written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, Durable Objects.

What license does computer use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is computer to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is computer for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.