Day, week, and month
Switch granularity while trends, KPIs, model mix, project and session tables, and relevant details stay synchronized.
tokens serve updates through a loopback-only local service. tokens dashboard exports the same interface as a self-contained offline HTML file.
tokens serve --open
tokens serve \
--source claude \
--source gemini \
--source codex
tokens serve --anonymize --since 2026-08-01The server binds only to 127.0.0.1 and checks safe file signatures every five minutes by default. The page can switch between 1, 5, 15, or 30 minutes, or pause refresh. If logs change, it reuses the parsed-file cache, publishes a new snapshot only when report data changed, and updates the current page without a full reload.
tokens dashboard --open
tokens dashboard --anonymize --since 2026-08-01The regular and pseudonymized exports use separate filenames and never overwrite one another. Exported HTML is a generation-time snapshot and does not watch for later log changes.
Switch granularity while trends, KPIs, model mix, project and session tables, and relevant details stay synchronized.
Standard checkbox chips support select all, clear, and one-step undo. No hidden double-click, right-click, or modifier gesture is required.
Open a period to recompute its local view. Hold C for a temporary previous-period outline, or explicitly pin the comparison.
Where logs expose identifiers, inspect project trends and retained per-turn token sequences. A session keeps at most the most recent 200 turns. The Top projects and sessions block starts collapsed; jumping to Top from the section dock expands it.
Fresh Input, Output, Cache Read, Cache Write, and Other reconcile to each source total. Cache Read is not presented as confirmed monetary savings.
Preview compatible views from a model, period, project, or session. Hold Alt/Option to expose exact values and semantic denominators.
Use the ⇄ compare two windows control to select interval A, then a following, equal-length interval B. Change Attribution then decomposes the A → B difference by model. Only consecutive complete periods qualify; select bars by click, drag, or focus plus Enter. Clearing the selection returns the card to a single-period comparison.
Open the highest complete period to read its profile: period total, previous-period delta when a full neighbour exists, model mix, the busiest recorded hour, and retained project evidence. It shows recorded aggregates only and does not assert an anomaly or fault.
The snapshot header names the latest recorded backend in range, folding uncommon names into “Other”. Caliber notes spell out what figures are not: six hourly buckets are not a billing window, cache-read share is not a currency-savings estimate, and the coverage denominator is the all-model total at the current granularity. Logged model names are kept as recorded.
Press I to organize the current range into a non-modal evidence path:
Exact tables plus CSV and Markdown exports remain available alongside charts. Module preferences are stored locally. Labs can be hidden when the core report is enough.
| Key | Action |
|---|---|
| 1 / 2 / 3 | Day / week / month. |
| T | Cycle system, light, and dark themes. |
| I | Open or return to Data Trail. |
| Hold Alt/Option | Temporarily show exact values. |
| Hold C | Temporarily compare with the previous period. |
| Cmd/Ctrl K | Open the command palette. |
| E | Export the current CSV view. |
| ? | Open in-dashboard help. |
| Esc | Close the active layer, then clear pinned context or leave a period probe. |
--anonymize replaces project, session, and title identifiers with report-scoped aliases. It still retains exact dates, models, values, aggregate relationships, and replay sequences, so it is pseudonymization rather than guaranteed anonymity.
Data Trail, Signal Dock, temporary exactness, and held comparison state stay in page memory. They do not add project or session IDs to URLs or localStorage. This browser-state boundary does not remove sensitive entities already embedded in a regular report.
Read the full privacy guide before sharing any generated file.