Start here

AI usage not showing in UsageAtlas? Check these settings

Fix missing providers, expired connections, and unreadable local history. Learn why a credit-only integration does not show token history.

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

StepCheckFix
1Is the tool writing session data?Run one session, then re-scan
2Is the path the one the tool uses?Compare with the provider guide
3WSL, container, or another user?Point at the real path
4Can the app read the file?Grant folder permissions
5Is the database locked?Close the CLI or copy the file
6Does 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.

Browse by topic