Quick answer
Start with the data path: most empty trackers are reading the wrong folder, usually because the tool runs in WSL, Docker, or a different user profile. Then check permissions, whether the database is locked, and whether the provider exposes a usage number at all. A tracker can only show what the tool wrote down.
The checklist, in order
| Step | Check | Fix |
|---|---|---|
| 1 | Is the tool writing session data? | Run one session, then re-scan |
| 2 | Is the path the one the tool uses? | Compare with the provider guide |
| 3 | WSL, container, or another user? | Point at the real path |
| 4 | Can the app read the file? | Grant folder permissions |
| 5 | Is the database locked? | Close the CLI or copy the file |
| 6 | Does the provider report quota? | Use local tokens instead |
Platform-specific causes
- Windows: the tool was installed in WSL, so data is in the Linux home.
- macOS: the app lacks access to the protected home folder.
- Linux: the app runs as a different user or in a container.
- Any platform: a fresh install with no completed sessions yet.
The Windows, Mac, and Linux setup guides cover the default locations.
When the data simply is not there
Some tools do not record token counts, and some providers do not expose a usage endpoint. In that case no tracker can invent the number. What you can do is record the reported balance over time and estimate the rest from session counts.
The local vs provider data guide explains which sources exist, and why numbers differ explains why two tools disagree even when both work.
Questions, answered
Why is my usage tracker showing zero?
Almost always a path problem: the tool writes data somewhere the tracker is not reading, often inside WSL, Docker, or another user profile.
Do I need to restart the tool after installing a tracker?
No, but you do need at least one completed session written to disk. A tracker cannot see work that produced no local record.
Why does one provider show no quota?
Not every provider exposes plan usage. For those, only local token history is available.