OTU: OpenCode Token Usage

A VS Code/Cursor extension that combines two sources of truth:

• local OpenCode message history from ~/.local/share/opencode/opencode.db
• live provider windows from Anthropic and Codex/OpenAI usage APIs

What it shows

• a status bar headline with provider summaries (live percent or fallback billing)
• a native dashboard tree view with:
  • Live Rate Limits
  • Live Billing
  • Monthly Billing
  • Monthly Tokens
  • Local History
  • optional Estimated 7h
  • Diagnostics
• user-selectable local history windows: 1h, 7h, 24h, 7d, 30d

Installation

• Install from the marketplace, or download a VSIX from GitHub Releases and install it directly.
• For local development, open this folder in VS Code or Cursor and launch the Extension Development Host.
• Local history works immediately as long as sqlite3 is available on PATH.
• To install the companion token-tracking plugin, run OTU: OpenCode Token Usage: Install Tracking Plugin from the command palette or the dashboard title actions.
• The command copies opencode-token-usage-tracker.js into ~/.config/opencode/plugins/.
• Restart OpenCode after installation so the tracker plugin is loaded.

GitHub / VSIX install

Download the latest .vsix asset from the GitHub Releases page:

https://github.com/DongHyunnn/opencode-plugin-token-usage/releases

Build a VSIX locally:

npm install
npm run package:vsix

Install the generated VSIX in VS Code:

code --install-extension ./opencode-token-usage-extension-2.0.1.vsix

If the cursor shell command is available on your machine, you can use the same VSIX from Cursor:

cursor --install-extension ./opencode-token-usage-extension-2.0.1.vsix

Convenience scripts are included:

npm run install:vsix:vscode:dry-run
npm run install:vsix:cursor:dry-run

Then run the real install command after packaging:

npm run install:vsix:vscode

or

npm run install:vsix:cursor

Marketplace install

Once the extension is published, install it from the VS Code extensions view by searching for OTU: OpenCode Token Usage, or from the CLI with:

code --install-extension DongHyunnn.opencode-token-usage-extension

Cursor officially supports extension installation from the Extensions UI. If the cursor shell command is available and the same extension id is resolvable there, the equivalent command is:

cursor --install-extension DongHyunnn.opencode-token-usage-extension

Open VSX / Cursor install

For Cursor/Open VSX compatibility, publish the same extension to Open VSX and install it from the Open VSX-backed extensions UI in Cursor.

If you want to publish manually after creating your Open VSX namespace and token:

npm run publish:ovsx -- -p "$OVSX_PAT"

The release workflow also supports Open VSX publishing when the repository secret OVSX_PAT is configured.

How it works

• OpenCode history is read from the local SQLite message table, which already stores provider, model, token, cost, and timestamp metadata.
• Anthropic and Codex live windows still come from provider APIs so their rate-limit windows stay authoritative.
• The optional 7h section is derived from local history and is intentionally labeled as an estimate.
• The history reader currently shells out to the local sqlite3 binary, so the host machine needs sqlite3 available on PATH.

Settings

• opencodeTokenUsage.databasePath
• opencodeTokenUsage.openCodeAuthPath
• opencodeTokenUsage.codexAuthPath
• opencodeTokenUsage.refreshIntervalSeconds
• opencodeTokenUsage.historyWindow
• opencodeTokenUsage.showEstimated7h

These paths are machine-scoped because they point to local editor/runtime state.

How auth is checked

• Claude (Anthropic): Uses openCodeAuthPath to read ~/.local/share/opencode/auth.json, reuses a valid anthropic access token until expiry, then refreshes with the stored refresh token.
• Codex/OpenAI: Reads both openCodeAuthPath and codexAuthPath; uses valid OpenCode access first; otherwise tries refresh tokens from either path; otherwise falls back to raw Codex access token only when no refresh path exists.
• Gemini: Reuses the existing google.key entry from openCodeAuthPath and is estimate-only (no live quota endpoint).
• Status bar fallback chain: live percent → vendor billing → estimated local 5h charge.
• Gemini quota visibility: Official quota and spend remain visible in AI Studio because the Gemini Developer API does not expose a lightweight authoritative remaining-quota endpoint.
• Diagnostics: Auth failures are categorized as not configured, expired, refresh failed, or fetch failed to help troubleshooting.

Development

npm install
npm run dev
npm test

Open the folder in VS Code or Cursor and run the extension host from the editor.

Local testing

• Cursor: open this folder and run the Run OTU: OpenCode Token Usage Extension launch configuration.
• VS Code: same flow; the repo now includes .vscode/launch.json.
• One-command launcher:

npm run dev

• Dry-run command resolution:

npm run dev -- --dry-run

• CLI alternative:

cursor --extensionDevelopmentPath="$(pwd)"

or

code --extensionDevelopmentPath="$(pwd)"

In the Extension Development Host, open the OTU: OpenCode Token Usage panel, then run OTU: OpenCode Token Usage: Refresh from the command palette if needed.