Track token usage and costs

Speedwave monitors model resource consumption through two interfaces: real-time telemetry displayed below the chat composer and an aggregated analytics dashboard tracking historical project usage. Both views read from structured audit records stored at <data_dir>/usage/<project>/proxy/usage.jsonl. See Token and credential paths for storage layouts.

Inspecting project usage

1. Real-time session status: Below the chat composer, inspect active metrics: prompt input tokens (in), completion output tokens (out), context window fill percentage (ctx), subscription rate limits (limit), and session cost (chat).

2. Terminal statusline: In CLI environments, Claude Code renders equivalent metrics:

   claude-opus-4-8 │ feat/docs │ CTX ██░░░ 40% │ 5h ██░░░ 30% reset 16:42 │ 7d █░░░░ 12% reset 14.04 │ $0.1409

   Rate limits display during Claude subscription sessions, while financial costs display when using direct API keys.

3. Historical analytics dashboard: Open the LLM Usage view to analyze workspace trends.

4. Aggregate summary cards: Inspect request volume, input/output token totals, prompt caching efficiency, decode throughput (tokens/second), error counts, and cumulative cost.

5. Detailed usage breakdowns: Review daily token distribution graphs, provider usage matrices, hourly activity heatmaps, and per-model consumption tables.

Speedwave deduplicates usage events using provider response identifiers. Corrupted records are logged and reported as skipped without interrupting metric aggregation.

Real-time estimation and finalized billing

During stream generation, displayed metrics reflect real-time tokenizer estimates. Once requests complete, the proxy records exact token counts from provider response headers.

Provider pricing models

Cost calculations adapt to the active provider configured in Settings → LLM providers (see LLM providers):

• Anthropic (API Key): Computes financial cost from official pricing catalogs, breaking down prompt input, completion output, cache write, and cache read rates (including 1M context tiers).
• Anthropic (OAuth Subscription): Displays a dash (-) indicating flat-rate subscription billing.
• Local model endpoints: Displays a dash (-), reflecting zero per-token cost for self-hosted instances.
• OpenRouter: Evaluates generation costs returned by the OpenRouter API. Initial requests may record a temporary deferred state deferred until generation settlement completes.

Failed requests incurring no upstream provider charges are not billed. For detailed internal billing states, refer to the Cost states reference.