opencode-quota

opencode-quota

OpenCode plugin that fetches subscription quotas for ChatGPT Codex, Google Antigravity, and z.ai.

Features

• /quotas command for all providers
• /quotas <provider> for a single provider
• Returns markdown summaries plus raw JSON
• Reads tokens from OpenCode and auth plugins

Installation in OpenCode

Create or edit ~/.config/opencode/opencode.json:

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

For local development, use a relative path:

{
  "plugin": ["./path/to/opencode-quota"]
}

Provider Setup

ChatGPT Codex

• Install the opencode-openai-codex-auth plugin, or ensure openai auth exists in ~/.local/share/opencode/auth.json.
• The plugin also checks ~/.opencode/auth/openai.json as a fallback.

Google Antigravity

• Install an Antigravity auth plugin (for example, opencode-antigravity-auth).
• Ensure accounts are stored in ~/.config/opencode/antigravity-accounts.json.
• The first configured account is used for quota checks.

z.ai

• Add a zai or z.ai entry in ~/.local/share/opencode/auth.json with the API key, or set ZAI_API_KEY.

Usage

/quotas
/quotas codex
/quotas antigravity
/quotas zai

Output

• markdown: human-readable summary
• json: provider-specific quota data

Development

bun install
mise run build
mise run test
mise run lint

Author

Nelson Pires [e-mail]

Repository

https://github.com/nelsonPires5/opencode-quota

License

MIT License. See the LICENSE file for details.