Quick answer
UsageAtlas is a free, open-source tracker that reads OpenCode's local database and shows tokens, cost, models, and sessions in one place. It runs on Windows, macOS, and Linux, keeps 7, 30, or 90-day history, and needs no account. Nothing is uploaded unless you enable cloud sync.
Start tracking in four steps
- Download UsageAtlas for your platform.
- Open it and let detection find the OpenCode data directory.
- If detection misses, paste the path shown in the database location guide.
- Open Today for the latest sessions, and History for daily totals.
The app reads the database in place. It does not copy, move, or modify OpenCode's files.
What you get
| View | Answers | Retention |
|---|---|---|
| Today | What ran and what it cost | Live |
| History | Daily token trend | 7 / 30 / 90 days |
| Insights | Model and project split | Same range |
| Alerts | Threshold warnings for connected providers | Per reset cycle |
Privacy and limits
- Local-first: no account needed for tracking.
- Cloud sync is opt-in and off by default.
- OpenCode has no provider window to alert on by itself; alerts need a connected provider.
- Cost is only as accurate as the rates the provider reports or the app applies.
What a tracker adds to the TUI
The TUI answers what is happening now. It does not answer what last Tuesday cost, which project consumed the month, or whether a model switch helped. A tracker reads the database and answers those questions without you writing SQL.
- Daily and weekly totals from the same source the TUI uses.
- Per-model and per-project splits.
- Cost estimates from token counts and published rates.
- Alerts before a limit rather than after a failure.
- The same view for your other tools, so totals are comparable.
UsageAtlas is free and open source and reads the database locally. The stats command guide covers the built-in alternative.
Questions, answered
Does UsageAtlas work with OpenCode Go?
It reads local OpenCode sessions, which include work done through OpenCode Go. Provider-side limits still come from OpenCode's own account view.
Does the tracker modify my OpenCode database?
No. It opens the database read-only and writes its own cache separately.
Can I track OpenCode without an account?
Yes. Local tracking requires no sign-in. An account is only for optional sync and public profiles.