---
title: "Full Config Reference"
description: "Complete reference for all nexus.config.yaml options. Option Type Default Description template string required Agent template name source string required Path to agent source status string idle Initial status sandbox.mem"
resource: https://www.aiagents.nexus/docs/manual/appendix/config-reference
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Full Configuration Reference

Complete reference for all `nexus.config.yaml` options.

## Top-Level Structure

```yaml
name: my-project
version: "0.1.0"

agents:
  # Agent definitions...

supervisors:
  # Supervisor definitions...

sagas:
  # Saga definitions...

workflows:
  # Workflow definitions...

pools:
  # Pool definitions...

cost:
  # Cost control settings...

broker:
  # Broker routing settings...

edge:
  # Edge deployment settings...

skills:
  # Skill definitions...

audit:
  # Audit settings...
```

## Agent Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `template` | string | required | Agent template name |
| `source` | string | required | Path to agent source |
| `status` | string | `idle` | Initial status |
| `sandbox.memory_limit` | string | `256MB` | Max memory |
| `sandbox.cpu_timeout` | string | `30s` | Max CPU time |
| `sandbox.network` | string | `restricted` | Network mode |

## Supervisor Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `strategy` | string | `one_for_one` | Restart strategy |
| `max_restarts` | number | `3` | Max restarts in window |
| `window_secs` | number | `60` | Restart window |
| `children` | list | required | Child agent names |

## Cost Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `default_budget` | number | `1000` | Default budget in cents |
| `alert_threshold` | number | `0.8` | Alert at this % |
| `hard_limit` | boolean | `true` | Enforce hard limits |