Repolode
Submit
cloudflare

cloudflare/computer

A virtual filesystem inside a Durable Object that gives AI agents a workspace with shell or JavaScript execution via container, Worker, or no backend.

View on GitHub
Stars
9,640
Forks
566
Open issues
29
Last commit
9 hours ago

What is it?

Cloudflare Computer keeps a workspace's authoritative state in SQLite inside a Durable Object and exposes it as a filesystem. Agents and applications can read and write files there and run code against them through a single `workspace.runtime.exec` entry point.

The execution layer is pluggable. The container backend mounts the state as a FUSE filesystem inside a sandbox container through a sidecar daemon called computerd, giving access to a full Linux userland. The Worker shell backend runs just-bash in a Dynamic Worker, and the Worker JavaScript backend evaluates ECMAScript modules with access to the workspace filesystem and host modules such as git and container access. A workspace can register several backends under stable IDs, and each connects lazily on first use.

The repository is a TypeScript monorepo with packages for the filesystem, RPC types, the computerd daemon, and the top-level Computer package. The container backend and Worker shell backend are marked experimental, and the package README describes which parts are considered production-ready.

Key features

  • 01Stores workspace state in SQLite inside a Durable Object as the source of truth.
  • 02Mounts the workspace as a FUSE filesystem in a sandbox container via computerd.
  • 03Runs shell commands with just-bash in a Dynamic Worker, without a container.
  • 04Evaluates ECMAScript modules in Dynamic Workers with workspace-backed fs/promises.
  • 05Lets one workspace register multiple execution backends selected by ID.

Use cases

  • Giving an AI agent a persistent working directory with shell access.
  • Running agent-generated code against workspace files in isolated Workers.
  • Building a chat agent that edits files and runs tools inside a Linux container.
  • Experimenting with Cloudflare Workers-based sandboxes for code execution.

Topics

#ai-agents#virtual-filesystem#cloudflare-workers#durable-objects#sandbox#sqlite#fuse#typescript

FAQ

What is computer?
A virtual filesystem inside a Durable Object that gives AI agents a workspace with shell or JavaScript execution via container, Worker, or no backend. Cloudflare Computer keeps a workspace's authoritative state in SQLite inside a Durable Object and exposes it as a filesystem. Agents and applications can read and write files there and run code against them through a single `workspace.runtime.exec` entry point.
Is computer free to use? What license does it have?
computer is open source under the MIT license. Check the license terms before using it in commercial products.
Is computer still maintained?
Actively maintained. The last commit to computer was on Oct 18, 2026.
What can I use computer for?
Giving an AI agent a persistent working directory with shell access. Running agent-generated code against workspace files in isolated Workers. Building a chat agent that edits files and runs tools inside a Linux container. Experimenting with Cloudflare Workers-based sandboxes for code execution.
Where can I get computer?
The source code and installation instructions are on GitHub: https://github.com/cloudflare/computer

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects