DocsConcepts
Tokens
Whaatcher counts your agent's tokens in four kinds: input, two kinds of cache, and output. Output tokens are the number it shows first.
The four kinds
- Input: the part of a request that doesn't use the cache.
- Cache write: the part saved to the cache so later requests can read it back.
- Cache read: the part read back from the cache, mostly the conversation so far.
- Output: what the model writes, its replies and tool calls, including its thinking.
Why output comes first
Each request reads the conversation so far back from the cache, so most of the total is usually Cache read. The total grows with the length of the conversation, not with what your agent wrote. Output is the agent's own work, so where Whaatcher shows one token number, it shows output and dims the total beside it.
No dollar amounts
Whaatcher shows tokens, never dollars. A price means something only when you pay per token through the API. On a subscription, your bill doesn't follow your tokens, and Whaatcher can't tell which plan you're on. So it doesn't estimate prices or weight the four kinds into one price-like number.
Where you see tokens
- The agent tile on the Workspace tab bar draws recent output tokens as a moving wave.
- In the Graph, the TOKENS column on each commit row shows the total of all four kinds. It is matched to the commit by time, so it is inferred.
- Worklog shows a commit's output tokens, with that same total dimmed beside them.
- Hindsight shows output tokens for the range you select, for each turn and along each lane.
- Insight shows output tokens by period and by repository in its Activity tab.
Where the numbers come from
Whaatcher reads token counts from the conversation files Claude Code keeps in ~/.claude/projects, and never writes to them. It counts only sessions you started in its terminal, as Run an agent explains, including their subagents. It keeps the numbers, not the conversation, and catches up on tokens used while it was closed.
Only Claude Code's tokens are counted. For other agents, Whaatcher says tokens aren't supported and leaves them out of totals instead of counting them as zero. See Supported agents and hosts. The access tokens you add for GitHub or GitLab are something else, covered in Accounts.