Skip to content
quoxcli

Check your AI spend budgets

Machine verified A machine ran this on our install and checked the result against the CLI. A test report is linked. CLI 0.3.1, checked 2026-10-15.

What am I spending on AI?

See the caps on your agents (cost, iterations, tokens) and how much of each is used, checked against the CLI.

What you get: the limits your agents run under, and how close they are, before you let them loose.

Ask Quox

Section titled “Ask Quox”

Ask about the limits in your own words:

quox · talking to Quox

What limits does my spend budget set: the iteration cap, the period it runs for, and does it stop work at the cap?

▤ AOCL │ L1 identity complete · allowed · 1ms

▤ AOCL │ L3 policy gate complete · proceed · 6ms

◐ SPEND │ status ✔ SPEND │ status │ 1 count, 1 budgets · 4.1s

⛓ AEE │ envelope opened · stream_success

You have one budget, scoped to the  sentinel-heartbeat  iteration.

• Iteration cap: 10,000 iterations. The cost cap is $1.00. There is no token, tool-call
  or duration limit.
• Period: 8 May 2026 to 7 June 2026, which is 30 days. That window has already ended,
  since today is 16 October 2026.
• Stops work at the cap: No. Hard stop is off, so reaching the cap doesn't block
  anything.

Nothing has been spent: $0.00 and zero tokens, so usage is 0%. Because the period has
lapsed and the budget never enforced a stop, it isn't constraining anything now. If you
want a live limit, you could create a new budget with hard stop on. I can give you the
exact command if you'd like.

22.1s · 1 tool · 0 approvals

A real turn on our own install (CLI 0.3.0, 16 Oct 2026), replayed at speed. Names changed. Type the same words into quox.
✔ Machine verified against the CLI on 16 Oct 2026 · test report mvb1p5

Quox read the budget and its usage: the caps, the period, whether work stops at the cap, and what has been used so far.

Do it yourself

Section titled “Do it yourself”

1. List every budget

Section titled “1. List every budget”
budgets 
quox budget listID         Scope    Scope ID   Period Start                Period End                  Max Cost (micro-USD)    Max Tokens    Hard Stop01M4YW…    org      01M4YB…    2026-10-01T00:00:00.000Z    2026-12-31T23:59:59.000Z    250000000               50000000      yes
From a real run on our demo organisation. Ids shortened.

The scope says what the budget covers (the whole org, one objective, one run). The cost cap is in micro-USD, so 250000000 is $250. With hard stop yes, work stops at the cap; with no, the cap is a line the run can cross, and the overage shows in the receipts.

Add --json to pipe it into another tool.

2. See what is used

Section titled “2. See what is used”
usage 
quox budget usage 01M4YW…Budget Usage: 01M4YW…totalTokens         0totalCostUsdMicro   0totalToolCalls      0totalDurationMs     0
From a real run on our demo organisation. Id shortened.

What just happened

Section titled “What just happened”

Reading a budget changes nothing, so it never raises an approval. Creating or changing one (quox budget create, quox budget update) is a separate, governed command that leaves its own receipt.

Check it yourself

Section titled “Check it yourself”

quox budget get <id> shows one budget in full.