Session-first
A Session is the durable conversation and work. Compute is a replaceable ExecutorLease; the Worktree and its checkpoints outlive any one sandbox.
SBX
Durable Sessions that run official provider CLIs in isolated Modal sandboxes, capture immutable ChangeSets, and deliver them as reviewed pull requests.
Official CLIs
SBX supervises the provider’s own CLI (OpenCode is supported, Codex is experimental). It runs no model loop of its own.
Immutable ChangeSets
Captured changes are sealed with a subject digest. Delivery pushes exactly that subject, and merge is gated on the same digest.
One API
A single /api surface serves the Console, the Python SDK and the CLI, with
one event journal and one watermark.
Where to go next
Section titled “Where to go next”- Introduction: what SBX is and is not.
- Quick start: self-host with PostgreSQL and run a first Turn.
- Concepts: the domain vocabulary.
- Sessions and Turns: events, cancel, retry, unknown outcomes.
- Python SDK and CLI.
- Configuration and security.