OpenCode

OpenCode usage tracker for tokens, models, and sessions

Track OpenCode usage locally: tokens, requests, models, sessions, and estimated cost, then see it beside Codex, Claude, and Cursor.

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

  1. Download UsageAtlas for your platform.
  2. Open it and let detection find the OpenCode data directory.
  3. If detection misses, paste the path shown in the database location guide.
  4. 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

ViewAnswersRetention
TodayWhat ran and what it costLive
HistoryDaily token trend7 / 30 / 90 days
InsightsModel and project splitSame range
AlertsThreshold warnings for connected providersPer 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.

Browse by topic