SYSTEM Cited by 1 source

Cloudflare Shell

@cloudflare/shell (github.com/cloudflare/agents/tree/main/packages/shell) provides a durable virtual filesystem inside a Durable Object, backed by SQLite. It exposes typed file operations — read, write, edit, search, grep, diff — that agent harnesses use as tools.

Motivation

Agent harnesses (coding agents especially) need a filesystem for reading files, writing outputs, searching code, and understanding diffs. A full container is expensive for what agents mostly do — text operations. @cloudflare/shell eliminates container overhead for the majority case.

(Source: Agents platform post.)

Architecture

• Storage: SQLite within the Durable Object (persists across executions)
• API: typed file operations (not a POSIX shell)
• Scope: one virtual filesystem per agent instance (one DO per agent)
• Upgrade path: @cloudflare/workspace syncs the virtual FS to a Cloudflare Container when full OS access is needed

Usage in Flue

On the Cloudflare target, Flue agents write JavaScript against the workspace virtual file state API powered by @cloudflare/shell, running operations within the Durable Object isolate model.

Seen in

• sources/2026-06-17-cloudflare-bringing-more-agent-harnesses-and-frameworks-to-cloudflare — first disclosure of @cloudflare/shell architecture
• sources/2026-04-15-cloudflare-project-think-building-the-next-generation-of-ai-agents — referenced as DO-backed filesystem in Project Think's execution ladder

Related

• systems/cloudflare-workspace — DO-to-container FS sync layer
• systems/cloudflare-durable-objects — storage substrate
• concepts/virtual-filesystem-over-sqlite — the concept this instantiates
• patterns/virtual-filesystem-over-container — the trade-off pattern