SYSTEM Cited by 1 source

Cloudflare Workspace

@cloudflare/workspace (github.com/cloudflare/workspace) keeps the virtual filesystem of a @cloudflare/shell Durable Object in sync with a Cloudflare Container's filesystem. This allows seamless transition from lightweight Workers-based file operations to a full Linux environment only when the agent needs it (e.g., npm install, git, compilers).

Design rationale

Most agent filesystem operations are text (read, grep, diff, patch). These run efficiently in a DO + SQLite via @cloudflare/shell. But some operations require a full OS. Rather than forcing all agents into containers, @cloudflare/workspace provides a graduated escalation: lightweight by default, full container on demand, with state kept in sync.

(Source: Agents platform post.)

Seen in

• sources/2026-06-17-cloudflare-bringing-more-agent-harnesses-and-frameworks-to-cloudflare — first disclosure

Related

• systems/cloudflare-shell — the lightweight virtual FS layer
• systems/cloudflare-containers — the full-OS fallback
• patterns/virtual-filesystem-over-container — the pattern this implements