opencode-usage

Simple CLI to view your OpenCode provider usage at a glance.

  OpenCode Usage
──────────────────────────────────────────────────────────────

  ● Claude
  5h window      █████████▊           54%       resets 1h 54m
  7d window      ███████████████      75%       resets 2h 54m
    Sonnet       1%
    Overage      $38.27 / $50.00

  ● Codex
    [email protected]  team · active
      Primary     ▊                     4%     resets 1h 15m
      Secondary   █▋                    8%     resets 5d 21h
      Credits     $0.00

    [email protected]  plus
      Primary     ████▎                21%     resets 48m
──────────────────────────────────────────────────────────────

Install

npm install -g @emilvooo/opencode-usage
# or
bun install -g @emilvooo/opencode-usage
# or
pnpm add -g @emilvooo/opencode-usage
# or
yarn global add @emilvooo/opencode-usage

Or run it directly without installing:

npx @emilvooo/opencode-usage
bunx @emilvooo/opencode-usage
pnpm dlx @emilvooo/opencode-usage

Usage

opencode-usage

That's it. Reads your OpenCode auth tokens automatically and fetches usage data in parallel.

If you use opencode-openai-multi-auth, all OpenAI accounts from ~/.config/opencode/openai-accounts.json are shown individually.

Supported providers

| Provider | Metrics | |----------|---------| | Claude (Anthropic) | 5h/7d usage windows, Sonnet/Opus breakdown, overage | | Codex (OpenAI) | Primary/secondary quotas, plan type, credits, multi-account support |

Requirements

• Node.js >= 18
• OpenCode installed and authenticated with at least one provider

How it works

1. Reads tokens from ~/.local/share/opencode/auth.json
2. Reads OpenAI multi-account tokens from ~/.config/opencode/openai-accounts.json when available
3. Fetches usage APIs for each configured provider in parallel
4. Displays color-coded progress bars (green < 50%, yellow < 80%, red >= 80%)

License

MIT