Budgets and receipts

Nib shows usage as your agents work, not at the end of the month. Every turn gets a receipt, Settings › Usage adds it up over time, and limits warn you or stop work before usage gets away from you.

Who pays, and how it showsCopy Anchor Link

Each model call is paid one of four ways, and Nib shows it in that payer's own unit:

Models on your machine (Ollama, LM Studio, vLLM, llama.cpp) cost nothing per token. How the plan, credits and invoices work is in Plans and billing.

ReceiptsCopy Anchor Link

When a turn finishes, the transcript shows a summary line with how long it took, how many tools ran and the tokens produced. When part of the turn was paid in money, the line adds that amount, for example $0.42 on credits or ≈ $0.31 on your Anthropic key. Work your plan covered adds nothing to the line. Click the line to open the turn's receipt.

A receipt breaks the turn down by model, including the small model Nib uses for titles and summaries, subagents, and any helper calls made during the turn:

• Input, output and cached tokens for each model.
• What each model used, in its payer's unit, and the turn's total.
• Cache saved: what prompt caching saved on this turn, shown when the whole turn was paid in money and it saved at least $0.01.
• The outcome: completed, interrupted, failed, or Paused at budget.

The Receipt pane (in the pane toggles next to Changes, Terminal and Files) lists every turn of the session, newest first. Expand a turn for its per-model split.

How amounts are shownCopy Anchor Link

Without a plan, the title bar shows today's spend. On a plan, the title bar shows no spend, and Nib tells you when you've used 75%, 90% and all of the plan's week (or month).

Settings › UsageCopy Anchor Link

Open Settings › Usage, or choose Usage from the composer's usage ring, the title-bar spend, the account menu, the command palette (⌘K), or the Receipt pane. Esc returns where you were. In a browser it's /account/usage.

From top to bottom:

• Limits: a card for each way of paying, then your fine rules.
• This computer: what this computer's sessions used.
• Your limits, when your organization sets them: what you've used beyond the plan, and Request more usage.
• For owners and admins: Usage by member, with the organization's activity and CSV exports.

LimitsCopy Anchor Link

Each card shows how much is used and what happens at its limit. A slider sets the limit and saves when you let go, and one sentence under it says the rule as it moves.

Subscription shows only on a plan, and Nib credits only where your plan sells credit or you hold a balance. Your keys and the fine rules belong to this computer's engine, so they show when you're connected to it.

At the limit offers these choices:

• Warn: Nib tells you and goes on.
• Ask: Nib asks whether to go on.
• Cheaper model: Nib switches to the model you pick.
• Stop: Nib stops until the limit resets.

Nib credits offer Ask, Cheaper model and Stop: credit stops at its monthly limit, so there's no Warn. Nib notifies you at 50% and 80% of a limit.

Fine rules are limits for narrower cases, each in its own unit and saying what it counts. Add a rule asks what it applies to (a folder by day or month, all projects by day or month, or each turn), the amount, what it counts (credits and your keys, your keys only, or credits only) and what happens at the limit. A rule that counts your plan's work alongside money shows no amount. Crew members' and teams' caps are listed under Nib Crew: remove one there, or Edit in Crew to change it in the member's or team's settings. Over remote control they're read-only.

When a hard limit is reached, the session pauses on a card in the session and in your inbox: finish this turn (the limit applies again from the next one), switch to a cheaper model, stop, or, for a money limit, raise it. With At the limit set to Stop or Cheaper model, Nib does that without asking. A session no one can answer, such as a crew member's, stops.

This computerCopy Anchor Link

What the sessions on this computer used, from its engine:

• Period: Today, This week (the default) or This month.
• Measure: spend or tokens. Spend is offered when something in the period was paid in money; work your plan covered is measured in tokens.
• Totals: what was used (your plan's share, and money only for what was paid in money), cache saved, tokens, and unpriced tokens (usage on models without a price).
• By day, plus tables By model, By workspace, By what ran, By identity and Most expensive sessions.
• Export CSV.

Sessions on other devices aren't included.

Limits in the Agent SDK and Nib CrewCopy Anchor Link

The Agent SDK and Nib Crew have limits of their own:

import { query } from "@nibapp/agent-sdk";

for await (const message of query({
  prompt: "Upgrade the test runner and fix what breaks",
  options: { maxBudgetUsd: 2 },
})) {
  if (message.type === "result") console.log(message.subtype, message.total_cost_usd);
}

NextCopy Anchor Link

• Plans and billing: what each plan includes, credits and invoices.
• Models and effort: pick lighter models for routine work.
• Race: compare models on the same task.