---
title: "Budget Enforcement"
description: "When an agent exceeds its budget, Nexus OS takes action. Mode Behavior hard Block all calls immediately (default) soft Allow current call, block next warn Log warning but allow calls"
resource: https://www.aiagents.nexus/docs/manual/cost-control/budget-enforcement
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# Budget Enforcement

When an agent exceeds its budget, Nexus OS takes action.

## Enforcement Modes

| Mode | Behavior |
|------|----------|
| **hard** | Block all calls immediately (default) |
| **soft** | Allow current call, block next |
| **warn** | Log warning but allow calls |

```yaml
cost:
  enforcement: hard
  budgets:
    researcher:
      daily: 1000
```

## Budget Reset

```bash
naos cost reset researcher
naos cost reset --all
```

## Alerts

```yaml
cost:
  alerts:
    - threshold: 80
    - threshold: 95
```
