Governer Vol 1 · 26 Oct 2026 · MIT · v1.0.0

A budget you cannot enforce is a suggestion.

Prices every request the way the provider bills it. Refuses the one that would cross your line.

$ pipx install governer $ governer box

One file · zero dependencies · Python 3.9+
github.com/Kaiser0733/governer

Fig. 1 — a run, wallet $10.00, cache missing
turn 1$2.02
turn 2$4.05
turn 3$6.07
turn 4$8.10
turn 5blocked
breaker tripped$8.10 of $10.00
paid, 5 turns$8.10
same run, cached$0.90
overpaid9×

The expensive failure is silent: status 200, normal output, cache reads billed on every replay. The provider never calls it an error.

receipt 656236f2d1e990f1… · chain intact

Why the bill grows while you sleep

The prefix is replayed

Million-token contexts are table stakes, so the whole cached prefix goes back on every call. Cache reads dominate an agent bill — and they are billed even when that text is truncated before the model reads it.

“Caching supported” is not caching

Every layer in the chain can assume prompt caching works while the actual agent stack misses it. Nothing in the stack reports that. One documented case: $37,901.73, of which $35.6k was uncached input.

Alerts are not limits

Email after the money is gone is not a safety mechanism. Neither are credits, nor a dashboard you check on Mondays. The only control that holds at 4am is a refusal.

Manifest of prices

modelin / Mout / Mcache readnote
claude-haiku-5-50.100.500.01~cheapest Anthropic
deepseek-v4-pro1.323.960.13~peak / off-peak billing
gpt-6-1-sol2.0010.000.20~cost leader, 1.05M ctx
claude-opus-5-54.0020.000.40~agentic coding, 1M ctx
gemini-3-8-flash0.753.750.08~doubles 2027-01-01
gpt-6-astra10.0050.001.00~frontier, 1.05M ctx

~ derived from the vendor convention (0.1× read, 1.25× write), not confirmed. governer prices --refresh pulls 459 models live, 313 with vendor-confirmed cache pricing.

Commands

governer proxy --limit 5OpenAI-compatible shim; refuses past $5, passes your own key through
governer check usage.json --limit 20true cost of a log, and where a $20 cap would have stopped it
governer boxsimulated agent in a virtual wallet, no API key
governer prices --upcomingannounced price changes
governer verify spend.jsonlis the ledger intact

Per-agent and per-day caps via X-Governer-Agent. --dry-run books the real spend and refuses nothing, so you can watch before you enforce.