opencode-quota

Quota, usage and cost in OpenCode TUI and Desktop.

English | 简体中文 | 繁體中文 | Français | Deutsch | 日本語 | Español

Install

opencode plugin add @slkiser/opencode-quota

Restart OpenCode and type /quota. A window opens with your limits. Click a tab (Usage, Limits, Plugin, or a Settings tab) or press tab to move between them; click or press esc to close it.

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@slkiser/opencode-quota"],
}

What you get

• TUI: a /quota window, a sidebar panel, a status line and toasts.
• Desktop (experimental, OpenCode 2.2.0+): a side tab, pills, a bottom strip, toasts, a usage window (Quota command) and a settings page. Turn it off in Settings → Extensions → Plugins.
  Where each setting shows in the TUI and in Desktop

  Setting group	TUI	Desktop
  sidebar	Quota panel in the sidebar	Quota side tab
  collapsed	Sidebar panel folded to one line per provider	Titlebar pill, and the Quota side tab when folded
  statusLine	Line under the message box	Strip at the bottom of the window, and the pill above the message box
  toast	Toasts with bars	Toasts with the Quota side tab's rows and bars; a reset notice is a sentence

  Note: in the TUI the status line hides while the sidebar shows quota, unless Next to the sidebar (statusLine.withSidebar) is on. In Desktop the strip also shows next to the Quota side tab by default; Next to the side panel (statusLine.withSidePanel) turns that off. statusLine.composerPill: false (Pill above the message box) hides only the pill in Desktop.

• Web: /quota, /quota_usage and /quota_status post a report in the chat. The AI never sees it.
• Terminal: npx @slkiser/opencode-quota@latest show, even with OpenCode closed.
• Scripts and status bars: JSON, an export file and metrics (how).
• Live settings in every open OpenCode.

Commands

For example /quota_usage 30d or /quota_usage between 2026-09-01 2026-09-25. In a terminal, with OpenCode open or closed, npx @slkiser/opencode-quota@latest show shows your quota and npx @slkiser/opencode-quota@latest status checks your setup (how they differ). Add --help to see all options.

Settings

• Change settings in /quota_settings (TUI) or the Quota page in Desktop’s settings. Both save to opencode-quota/settings.jsonc in OpenCode’s config folder and keep your comments.
• Custom providers, the Claude CLI path and the export path are set only in the file.
• The ┃ in a bar marks even use until the reset. Even-use mark (layout.evenUse) turns it off.
• Settings and defaults

Providers

Log in with /connect and the provider shows up. Switch providers on or off in /quota_settings → Providers.

* Linked names need one more step; the rest work once you log in. What each one reports.

• OpenAI ChatGPT needs a Codex login (how).
• Gemini CLI works only with Gemini Code Assist Standard or Enterprise (organization) accounts. Personal Google accounts use Google AGY.
• Business plans of the Chinese providers show only your own API key’s usage (Alibaba Token Plan: one Credits row per seat).
• API keys come from OpenCode or an environment variable.

Custom providers

Track any other provider, from its quota API or from a local estimate. Ask your agent to add a custom provider: it is saved switched off, and you switch it on in /quota_settings → Providers. Copy-paste prompt.

Updating

opencode plugin update

Restart OpenCode. Coming from 4.x or 5.x? Your settings convert on the first start, and the old /tokens_* commands still work. See Updating.

Troubleshooting

1. Run /quota_status in an OpenCode session, or npx @slkiser/opencode-quota@latest status in a terminal.
2. Provider missing? Log in to it again in OpenCode 2.
3. Using a companion plugin (Cursor, Google)? List it before @slkiser/opencode-quota in opencode.json.
4. claude or bl not found? See Service environment.
5. /quota_usage empty? Start OpenCode once, then use a model.
6. No Quota GUI in Desktop? It needs OpenCode 2.2.0+ and its switch on in Settings → Extensions → Plugins. Web shows no plugin GUI.

More fixes: Troubleshooting.

Reference

Guides: Configuration · Providers · Troubleshooting · External integration · Updating

Outside links: OpenCode docs · OpenCode config · OpenCode plugins · OpenCode TUI · models.dev pricing data · Node.js downloads

Contributors

Thanks to everyone who has contributed to OpenCode Quota.

License

MIT. OpenCode Quota is not built by the OpenCode team and is not affiliated with OpenCode or any provider listed above.