Cost
Spend rollups, budgets, alerts, and billing context for your workspace.
Cost (nav label; screen title "Budgets, quotas & usage") is the Cost Guard cockpit. It shows live and historical LLM spend, per-provider breakdowns, budget configuration, and — on cloud workspaces — plan and invoice context.
Layout
The screen uses a tabbed layout:
- Overview — top-card totals, sparkline (today / week / month), and provider breakdown table.
- Budgets — create, edit, and evaluate spend budgets with alert channels.
- Alerts — muted and active budget alerts.
- Billing — plan tier, invoices, and backend-computed usage state (cloud only; deep-link via
tab=billing).
Budgets and alerts
Each budget defines a spend cap and evaluation window. Evaluate runs synchronously against the cost tracker; in-flight runs may not yet be reflected — the UI shows "as of" timestamps from cost.updatedAt.
Reset counters is destructive: it requires confirmation, writes an audit entry, and should only be used after operator review.
Cloud vs self-hosted
On self-hosted desktop installs, billing tabs may show a disconnected state honestly — the UI does not synthesize plan or invoice data. Usage limits on cloud tenants come from usage.state.get (backend-computed; do not recalculate limits in the UI).
Deep links
Commercial notifications can open Cost directly on the Billing tab (tab=billing). The screen consumes one-shot navigation params after mount.
Related screens
| Need | Go to |
|---|---|
| Per-run cost | Activity run detail |
| Access / RBAC for cost exports | Governance |
| Dashboard spend summary | Dashboard |