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.