---
title: "Budgets"
description: "Nexus OS tracks every API call, LLM token, and resource usage. Set budgets to prevent runaway costs. Output: When an agent hits its budget limit, the configured action is taken: Action Behavior pause Agent is paused unti"
resource: https://www.aiagents.nexus/docs/cost-control/budgets
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Cost Budgets

Nexus OS tracks every API call, LLM token, and resource usage. Set budgets to prevent runaway costs.

## Setting a Budget

```bash
# Set a daily budget for an agent
naos cost set researcher --budget 10.00 --period day

# Set a monthly budget
naos cost set researcher --budget 200.00 --period month
```

## Viewing Costs

```bash
naos cost status
```

Output:

```
AGENT       BUDGET      SPENT     REMAINING   PERIOD
researcher  $10.00/day  $3.42     $6.58       resets in 8h
analyzer    $5.00/day   $1.20     $3.80       resets in 8h
planner     $20.00/day  $0.00     $20.00      resets in 8h
─────────────────────────────────────────────────
TOTAL       $35.00/day  $4.62     $30.38
```

## Budget Enforcement

When an agent hits its budget limit, the configured action is taken:

| Action | Behavior |
|---|---|
| `pause` | Agent is paused until budget resets |
| `warn` | Warning logged, agent continues |
| `stop` | Agent is stopped permanently |
| `throttle` | Agent rate-limited to 10% capacity |

## Configuration

```yaml
cost:
  budget: "$100/day"
  alertAt: 80        # alert at 80% usage
  action: pause      # what to do at 100%

agents:
  researcher:
    cost:
      budget: "$10/day"
      action: throttle
```

## Resetting Costs

Manually reset an agent's spend counter:

```bash
naos cost reset researcher
```