---
title: Cost
description: 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](/docs/using-the-app/runs-and-observability) run detail |
| Access / RBAC for cost exports | [Governance](/docs/using-the-app/governance) |
| Dashboard spend summary | [Dashboard](/docs/using-the-app/dashboard) |