@bigjade/opencode-usage
v0.1.3
Published
OpenCode TUI sidebar plugin for provider usage and quota visibility
Readme
@bigjade/opencode-usage
OpenCode TUI sidebar plugin that shows provider usage/quota when a safe local source is available.
What It Shows
- Active OpenCode model/provider.
- Provider usage bars with percentages when supported.
- Clear
usage API unavailablemessages when provider account usage cannot be queried safely.
Usage data refreshes every 5 minutes while the sidebar is mounted. Run /opencode-usage in OpenCode to refresh the sidebar immediately.
Supported usage sources:
| Provider | Source |
|---|---|
| Claude | Local Claude Code OAuth credentials in ~/.claude/.credentials.json plus Anthropic OAuth usage API |
| OpenAI / Codex | Read-only ~/.codex/auth.json credentials with ChatGPT https://chatgpt.com/backend-api/wham/usage usage endpoint; optional model label from ~/.codex/config.toml |
| Gemini | Read-only ~/.gemini/oauth_creds.json plus optional ~/.gemini/settings.json; Google Code Assist loadCodeAssist project discovery and retrieveUserQuota quota endpoint |
| z.ai | ANTHROPIC_BASE_URL restricted to z.ai/BigModel origins plus ANTHROPIC_AUTH_TOKEN with /api/monitor/usage/quota/limit quota endpoint |
| MiniMax | MINIMAX_TOKEN_PLAN_API_KEY or MINIMAX_API_KEY with Token Plan endpoint |
| OpenRouter | OPENROUTER_API_KEY with /api/v1/auth/key |
Providers without a verified local quota API, such as direct DeepSeek or direct Qwen/DashScope, are labeled but not faked.
Credential files and environment tokens are read only. Tokens are never displayed, logged, cached, or stored by this plugin, and provider CLIs such as codex or gemini are not executed.
Install From Local Tarball
npm install
npm run build
npm test
npm pack
opencode plugin .\bigjade-opencode-usage-0.1.3.tgz --globalRestart OpenCode after installation.
Registry Install
When the package is published to npm, install it with:
npm install @bigjade/opencode-usageEnvironment Variables
Only these optional variables are read. Token values are never displayed or stored.
GOOGLE_CLOUD_PROJECT
GOOGLE_CLOUD_PROJECT_ID
ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN
MINIMAX_TOKEN_PLAN_API_KEY
MINIMAX_API_KEY
OPENROUTER_API_KEYLocal Development
npm install
npm run build
npm test
npm run pack:dryDo not publish or distribute generated .tgz files containing private changes without review.
