Skip to content

CONCEPT Cited by 1 source

Virtual filesystem over SQLite

Definition

A design approach where an agent's filesystem is implemented as typed file operations (read, write, edit, search, grep, diff) backed by SQLite storage inside a serverless compute primitive (e.g., a Durable Object) rather than a full Linux container. The filesystem persists across executions and is durable, but avoids container boot overhead.

(Source: Agents platform post.)

Rationale

The majority of agent filesystem operations are text: reading files, grepping source code, writing patches, understanding diffs. A full container (Linux boot, filesystem mount, process isolation) is expensive for what is fundamentally structured text I/O. SQLite-backed virtual FS provides:

  • Persistence across serverless invocations
  • Durability (DO SQLite is transactional)
  • Speed (no cold boot; operations are in-process)
  • Cost efficiency (no per-invocation container overhead)

Escalation path

When agents need a full OS (npm install, git, compilers), @cloudflare/workspace syncs the virtual FS to a container — graduated escalation rather than container-by-default.

Seen in

Last updated · 542 distilled / 1,571 read