Skip to content
CantelopBeta

Workspaces

A Workspace is your agent's persistent filesystem, mounted at /workspace inside each Sandbox.

  • Capability: store files, generated artifacts, and saved agent state using ordinary filesystem APIs. The Session process starts in /workspace, so relative paths use persistent storage.
  • Durability: files survive Sandbox termination and are available to new Sandboxes. In-memory state and temporary files outside the Workspace do not persist; your agent must save and reload the state it needs.
  • Sharing: multiple Sessions can mount the same Workspace, including Sandboxes running in parallel. They access the same files through NFS (Network File System), with concurrent reads and writes. Your application coordinates conflicting writes.

Workspaces belong to an App. Opening the same slug in that App returns the same Workspace. Choose a user, account, or team as the owner; use separate Workspaces when their files should stay separate.

See the SDK Workspace guide for opening Workspaces and attaching them to Sessions.