Specs
Choose a complete TOML format for an agent, team or cloud resource. Each reference starts with Every Option and shows the spec before its explanations.
Shared Definitions
Agents share an [access] section that says which people and services may
act on an agent. Agent Access
explains the rules.
Some specifications compose access rules and schedule definitions from their
owning types. Their checked references explain those shared fields without
turning each nested definition into a separate specification kind.
Configuration Guides
Learn composition, resource selection, and permission rules in the Spec Guides before you choose individual fields.
Composing Specs
The Agent Spec references an agent's model, instructions, tools, and connections. The Team Spec defines a roster, lead, and settings shared by its members.
Machines and Environments
Use the Box Spec for a cloud machine's resources and attachments, and the Env Spec for the system, setup stages, and services prepared on a machine.
Permissions and Policies
The Sandbox Spec references grants on files, programs, and network access. The Policy Spec describes a principal's allowed actions and resources.
Shared Design Rules
Every spec follows common rules. Spec Decisions explains them and the rationale behind the individual formats.
Composition Guides
The Agent Spec Guide explains how an agent's specs meet as sets. The Team Spec Guide explains how a team's file makes its roster. The Box Spec Guide explains how a box spec picks its machine. The Sandbox Spec Guide explains what a sandbox spec opens and refuses. The Policy Spec Guide explains a policy's actions and resources. The Bundle Spec says which programs a release of your own builds.
Agent Behavior
An agent's schedule definitions choose when work runs, and its connection policy sets which messages it answers.