Guide
Usage and analytics
How session readings work, what confidence means, and how history and insights are calculated.
How readings are taken#
While Claude is open, ForgeTally watches the page for changes and reads three values when Claude displays them: your session usage percentage, the time until your usage resets, and the model selected in the model picker.
It matches on visible text and accessibility attributes rather than on Claude’s internal class names, which change between deploys. It skips the conversation itself and the message composer entirely, so a percentage mentioned in a chat is never mistaken for a usage figure.
Detection is event-driven. ForgeTally does not poll, and it limits how much of the page a single scan may visit so it cannot slow Claude down.
Unknown values#
If a value is not on the page, ForgeTally shows Unknown. It does not estimate, interpolate or carry a number over from somewhere else.
Confidence#
Each reading carries a confidence rating describing how it was obtained — not how plausible the number looks.
| Rating | Meaning |
|---|---|
| High | Read from structured page state, such as an accessible progress bar labelled as usage, or an explicit countdown. |
| Medium | Read from a short label that states the value next to a usage word, or a model name from an interactive control. |
| Low | A number qualified only by nearby labels in other elements. |
| Unknown | Nothing was read. |
In the popup, confidence appears as a small coloured dot beside the reset time and the model.
Reset timer#
A countdown such as "resets in 2h 12m" is read directly. A clock time such as "resets at 3:00 PM" is converted to the next time that clock time occurs. Both are shown to the nearest minute, because that is the precision Claude displays.
History#
Readings with a usage percentage are recorded to local history. A reading is saved when the percentage or model changes, or at most every five minutes if nothing has. History is kept for 180 days and older days are removed automatically.
The History view lists readings newest first, and you can export everything retained as a CSV file.
Insights#
- Weekly average is the average of each day’s average, over days that have data.
- Days without data are left as gaps. They are never counted as zero.
- Current streak counts consecutive days with readings. An empty today does not break it; an empty yesterday does.
- Trend compares the older and newer halves of the last 14 days, and is only shown with at least four days of data. A change under five percentage points is reported as stable.
Something wrong or unclear on this page? Use the feedback button in the corner of the site — it saves a file on your device and sends nothing.