Skip to main content
SQL keeps workspace files in a database’s tables, laid out as AgentFS’s. The files last as long as the database does.

Connect

workspace.yaml

Layout

  • path is a SQLite file; leave it out to keep the database in memory. The file holds the tables fs_inode, fs_dentry, fs_data and fs_config.
  • root: /workspace under config serves only that folder, made when missing. Several mounts can share one database this way, and a mount of the whole database lists the folder too.
  • A Postgres server, a Durable Object’s storage or a D1 database mounts from code, through its driver; see the SDK guides.

Sample runs

Every command that writes works on a write mount. Add capacity: 100MB under config to cap the bytes the database’s files hold, whichever folder they are in; see capacity.

SDK guides

Python

Every config field, the VFS.md and write support.

TypeScript

Every config field, the VFS.md and write support.