explaingit

cloudflare/computer

Analysis updated 2026-08-13

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

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

TypeScriptCloudflare WorkersDurable ObjectsSQLiteFUSE

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.