Skip to main content
A workspace is a bounded collection of items shared with members. Each workspace has its own item tree, tabs, AI chat threads, membership, and invites. Think of it as the place where the work happens: you keep the actual source material in view, open what you need, and ask AI against the context you choose.

​
What Lives in a Workspace

​
Roles

Viewers can inspect content but cannot mutate workspace items. The app shows view-only affordances when a viewer opens mutation controls.

​
Source of Truth

The app stores workspace access, the item tree, relationships, current document checkpoints, and extracted text in Postgres. Original and preview file bytes live in R2. The WorkspaceRoom Durable Object coordinates presence, workspace-page deltas, and cleanup; it is not a second database. Clients apply canonical item deltas and refetch the authoritative workspace query after reconnecting or when a full refresh is announced. UI and AI operations go through workspace persistence boundaries rather than writing directly to scattered client state.