Token Telemetry — Measuring AI Coding Activity
The privacy-preserving unit of measurement for AI coding. Four integers capture the full token cascade — without reading a single word of your prompts.
What token telemetry is
Token telemetry is the on-device measurement of AI coding activity through token counts. Every interaction with an AI coding tool — a prompt sent to Claude, a completion from Copilot, a chat turn in Cursor — moves tokens through a cascade: you send some in, the model sends some back, and prompt caching reuses or writes context for the next turn. Telemetry records the counts at each stage. Four numbers, per session, per platform. That is the entire data layer.
It is the foundation everything else in SigRank is built on. Without telemetry there are no metrics, no leaderboard, no operator scoring. With it, you get a complete, privacy-preserving picture of how efficiently you drive your AI tools — measured not in hours or keystrokes, but in the actual currency of LLM compute: tokens.
The four pillars
Every token in an AI coding session falls into exactly one of four buckets. Together they describe the full flow of the cascade.
Input
Fresh tokens you send to the model. The cost side of the cascade — every input token is a spend.
Output
Tokens the model generates back. The return side — what you actually keep from the exchange.
Cache-read
Cached tokens reused from prior context via prompt caching. The compounding layer — signal you already paid for, served again for free.
Cache-write
New tokens written to cache for future reuse. An investment in the next turn — you pay now to compound later.
Why token counts, not prompt content
The central privacy design choice in SigRank is this: measure the counts, never the content. Four integers — input, output, cache_read, cache_write — fully describe the architecture of a token cascade. They tell you whether signal is compounding (high cache reuse, high output per fresh input) or tokens are burning (low cache, low output). You do not need a single word of the prompt or the response to know that.
This is what makes token telemetry privacy-preserving by construction. The scanner reads counts and content lengths locally. Only the resulting numeric scores, signed with ed25519, leave your device. Server-side verification operates on integers — replay guards, plausibility checks — never on text. Your prompts, your code, your conversation history never leave your machine.
The tradeoff is deliberate: you give up the ability to analyze what someone said to their AI, and in exchange you get a measurement system that is safe enough to run continuously, across 15+ platforms, and publish to a public leaderboard. Token counts are the unit that makes a global operator ranking possible without a privacy scandal.
Explore the category
Yield (Υ) Cascade
The headline metric: cache_read × output / input². Measures the architecture of your token cascade.
Compression Ratio
Output divided by input — how much you get back per token you put in.
Signal-to-Noise Ratio (SNR)
Signal tokens over total tokens — the density of useful output in your cascade.
Cache Hit Rate
How well you reuse cached context: cache_read / (cache_read + cache_write).
Leverage
cache_read / input — how much cached context amplifies your fresh input.
Velocity
output / session_time — tokens produced per unit of wall-clock time.
How to Track Your Token Cascade
A step-by-step guide to capturing the four pillars from your AI coding sessions.
Yield Calculator
Paste your token stats and see your Υ Yield, class tier, and compression ratio instantly.
FAQ
- What is token telemetry?
- The on-device measurement of AI coding activity through four token counts — input, output, cache-read, and cache-write. It records how many tokens flowed through your sessions without ever reading the content of your prompts or the model's responses.
- Why token counts instead of prompt content?
- Four integers fully describe the architecture of a token cascade without revealing a single word. Token counts are the privacy-preserving unit that makes a global, continuous operator ranking possible without reading anyone's prompts.
- What are the four token pillars?
- Input (fresh tokens sent), output (tokens generated back), cache-read (cached tokens reused from prior context), and cache-write (new tokens written to cache for future reuse). Together they describe the full flow of tokens through a session.
- How do I collect token telemetry?
- Install the SigRank CLI (
npm install -g sigrank), runsigrank enroll, and submit a snapshot. The on-device scanner reads token counts locally and publishes a signed snapshot. No message content leaves your machine. - Is token telemetry private?
- Yes. The scanner reads token counts and content lengths only — never the words of your prompts. Only ed25519-signed numeric scores leave your device, and server-side verification operates on integers, not text.