opencode-firmware-quota

OpenCode plugin for monitoring your Firmware API quota usage.

Features

- firmware_quota tool - AI can check your quota on demand
- Auto-show on session start - See your quota when starting a new session
- Low quota warnings - Get notified when usage exceeds 75% or 90%

Installation

Add to your opencode.json:

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

Configuration

Connect your Firmware account using the /connect command in OpenCode:

`
/connect
`

Search for Firmware and enter your API key from app.firmware.ai.

OpenCode handles secure storage of your API key. This plugin only accesses it to make direct requests to Firmware's quota API endpoint—nothing else. The code is open-source and can be reviewed to verify this.

Usage

$3

Ask the AI to check your quota:

`
Check my Firmware quota
`

The AI will use the firmware_quota tool and display your current usage.

$3

- Session start: Quota is displayed when you start a new session
- Low quota (75%+): Warning notification shown
- Critical quota (90%+): Error notification shown

Optional: /usage Slash Command

If you prefer a slash command, you can create a custom command file. Note that this will go through the AI (uses tokens).

Create ~/.config/opencode/commands/usage.md:

`markdown
---
description: Check Firmware API quota
---
Check my Firmware quota using the firmware_quota tool and show me the result.
`

Then use /usage` in OpenCode to trigger it.

License

MIT