1. Create a fine-grained PAT at GitHub with Account permissions > Plan > Read
2. Create ~/.config/opencode/copilot-quota-token.json:

`json
{
"token": "github_pat_...",
"username": "your-username",
"tier": "pro"
}
`

Tier options: free, pro, pro+, business, enterprise

`jsonc
{
"provider": {
"firmware": {
"options": {
"apiKey": "{env:FIRMWARE_API_KEY}",
},
},
},
"experimental": {
"quotaToast": {
"enabledProviders": ["firmware"],
},
},
}
`

The apiKey field supports {env:VAR_NAME} syntax or a direct key.

Firmware-specific command: Use /firmware_reset_window confirm to reset your 5-hour spending window (consumes 1 of 2 weekly resets). Running without confirm shows a warning first.

`jsonc
{
"provider": {
"chutes": {
"options": {
"apiKey": "{env:CHUTES_API_KEY}",
},
},
},
"experimental": {
"quotaToast": {
"enabledProviders": ["chutes"],
},
},
}
`

Requires the opencode-antigravity-auth plugin for multi-account support:

`json
{
"plugin": ["opencode-antigravity-auth", "@slkiser/opencode-quota"]
}
`

Account credentials are stored in ~/.config/opencode/antigravity-accounts.json.

This section provides instructions for LLM agents to install and configure opencode-quota based on the user's current OpenCode setup.

#### Step 1: Check Current Configuration

First, determine what providers the user has connected. You can:

1. Read the user's opencode.json (typically at ~/.config/opencode/opencode.json)
2. Run /connected in OpenCode to see active providers
3. Ask the user which providers they use

#### Step 2: Install the Plugin

Add the plugin to the user's opencode.json:

`json
{
"plugin": ["@slkiser/opencode-quota"]
}
`

If the user already has plugins, append to the existing array.

#### Step 3: Configure Providers

Based on the user's connected providers, add the appropriate enabledProviders:

`jsonc
{
"experimental": {
"quotaToast": {
"enabledProviders": [
// Add only the providers the user has configured:
// "copilot" - if using GitHub Copilot
// "openai" - if using OpenAI/ChatGPT
// "firmware" - if using Firmware AI
// "chutes" - if using Chutes AI
// "google-antigravity" - if using Google Antigravity (requires opencode-antigravity-auth)
],
},
},
}
`

#### Provider Detection Guide

| If user's config has... | Add to enabledProviders |
| ------------------------------------------- | ----------------------- |
| github-copilot provider or Copilot models | "copilot" |
| openai / chatgpt provider | "openai" |
| firmware / firmware-ai provider | "firmware" |
| chutes provider | "chutes" |
| google provider with antigravity models | "google-antigravity" |
| opencode-antigravity-auth in plugins | "google-antigravity" |

#### Example: Full Configuration

For a user with Copilot and Google Antigravity:

`jsonc
{
"plugin": [
"opencode-antigravity-auth", // Required for google-antigravity
"@slkiser/opencode-quota",
],
"experimental": {
"quotaToast": {
"enabledProviders": ["copilot", "google-antigravity"],
"googleModels": ["CLAUDE"], // Options: CLAUDE, G3PRO, G3FLASH
"minIntervalMs": 300000, // 5 minutes between fetches
"toastDurationMs": 9000, // Toast shows for 9 seconds
},
},
}
`

#### Step 4: Verify Installation

After configuration, instruct the user to:

1. Restart OpenCode (or reload the window)
2. Run /quota_status to verify providers are detected
3. Run /quota to manually trigger a toast

#### Common Issues

- Toast not showing: Run /quota_status to diagnose
- Google Antigravity not working: Ensure opencode-antigravity-auth` plugin is installed and accounts are configured
- Copilot quota unreliable: Consider setting up a fine-grained PAT (see Provider-Specific Setup above)