Fystash

Documentation

Dashboard

concepts

Shared drive

Durable POSIX artifact filesystem shared by sandboxes in a room.

Mount appears inside guests (typically under /mnt/drive). Prefer writing large outputs to the drive and sending short fabric messages with paths.

Control-plane helpers

MCP: fs_read, fs_write, fs_list

REST:

  • POST /v1/rooms/{room_id}/drive/write
  • GET /v1/rooms/{room_id}/drive/list
  • GET /v1/rooms/{room_id}/drive/read

Isolation

  • Org A cannot see Org B drives
  • Room A paths are not visible to Room B sandboxes
  • Direct POSIX I/O inside the guest is not fully audited; control-plane drive calls and room audit cover API-visible events

Quotas

Drive storage is soft-capped per org. See Tenancy and Credits.