Budgets & cost control

Autonomous agents can run up a model bill quickly. Hezo tracks every run's cost and lets you cap spend at both the agent and the project level.

Cost tracking

Each agent run records what it cost, based on the tokens it used and the pricing for the model it ran on. Costs roll up two ways (per agent and per project), so you can see exactly where spend is going from the budget view.

Model pricing ships built in and refreshes daily from pricepertoken.com, so rates stay current without any setup. Recorded costs are a conservative upper-bound estimate: token costs are computed at non-cached rates (cached reads and writes are billed at the full input rate), and providers charge much less for cache traffic - so your real bill is typically lower than the figure Hezo shows, never higher. For exact billing on a model (or to correct a rate), add a manual pricing override in Settings - overrides win and can include cache rates.

Budget windows

You set limits over three rolling windows, in UTC:

• Daily - from the start of the day.
• Weekly - from the start of the week (Monday).
• Monthly - from the start of the month.

Limits apply to both agents and projects, independently. A limit of zero means unlimited for that window.

Enforcement

When an agent (or the project it belongs to) reaches a budget limit in any window, its runs are paused. The agent automatically resumes when that window rolls over (the next day, week, or month). This gives you a hard ceiling on spend without having to babysit it: set a daily cap and a runaway agent simply stops until tomorrow.

You can also pause and resume agents yourself at any time, independently of budgets.