01
Only aggregate token rows
The collector sends UTC date, tool, model, token counts, and estimated cost. It never uploads code, prompts, chats, filenames, or file contents.
Protocol / public trustRevision / 07
Rules
Measure usage. Protect the work.
TokenRank is a public leaderboard for collector-reported aggregate AI activity. It is an activity signal for comparison and sharing—not a provider audit or productivity score.
Operating protocol
07 / Ground rules
02
Main board uses raw tokens
Codex uses provider raw input + output because its input already includes cached input. Claude Code and similar tools add input, output, cache reads, and cache writes.
03
Server recomputes totals
Collectors send aggregate fields, but the server recomputes total tokens from the raw fields before writing leaderboard rows.
04
Same device, same day overwrites
Repeated uploads from one device for the same UTC date, tool, and model replace the old row instead of stacking duplicate points.
05
Top three devices count
Each user only ranks with the three highest-usage devices in a leaderboard window, reducing the upside of fake devices.
06
Suspicious rows can be removed
The server validates tools, dates, integers, recomputed totals, webhook ownership, and duplicate keys. These checks do not turn local data into Provider Verified usage; suspicious records can be flagged, hidden, or removed.
07
X sharing is user-controlled
The MVP opens an X Web Intent. TokenRank does not auto-post and does not request posting permissions.