Skip to content

README.md

Latest commit

 

History

History
222 lines (150 loc) · 6.49 KB

README.md

File metadata and controls

222 lines (150 loc) · 6.49 KB

opencode-mystatus

npm version npm downloads License: MIT

An OpenCode plugin to query account quota usage for multiple AI platforms.

中文文档

Check AI Quota in One Click

Supported Platforms

Platform Account Type Data Source
OpenAI Plus / Team / Pro ~/.local/share/opencode/auth.json
Zhipu AI Coding Plan ~/.local/share/opencode/auth.json
Z.ai Coding Plan ~/.local/share/opencode/auth.json
GitHub Copilot Individual / Business ~/.local/share/opencode/auth.json
Google Cloud Antigravity ~/.config/opencode/antigravity-accounts.json

Installation

Let an LLM do it

Paste this into any LLM agent (Claude Code, OpenCode, Cursor, etc.):

Install the opencode-mystatus plugin by following: https://raw.githubusercontent.com/vbgate/opencode-mystatus/main/README.md
Instructions for LLM agents

To install this plugin, perform these steps:

  1. Add "opencode-mystatus" to the plugin array in ~/.config/opencode/opencode.json

  2. Add the slash command to the command object in the same file:

{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool to query quota usage. Return the result as-is without modification."
    }
  }
}
  1. Tell the user to restart OpenCode.

Manual Installation

  1. Add the plugin and slash command to your ~/.config/opencode/opencode.json:
{
  "plugin": ["opencode-mystatus"],
  "command": {
    "mystatus": {
      "description": "Query quota usage for all AI accounts",
      "template": "Use the mystatus tool to query quota usage. Return the result as-is without modification."
    }
  }
}
  1. Restart OpenCode

From Local Files

Copy the plugin files to your OpenCode config directory:

  1. Copy plugin/mystatus.ts and plugin/lib/ to ~/.config/opencode/plugin/
  2. Copy command/mystatus.md to ~/.config/opencode/command/
  3. Restart OpenCode

Usage

Option 1: Slash Command

Use the /mystatus command to get complete quota information:

/mystatus

Option 2: Natural Language

Simply ask in natural language, for example:

  • "Check my OpenAI quota"
  • "How much Codex quota do I have left?"
  • "Show my AI account status"

OpenCode will automatically use the mystatus tool to answer your question.

Output Example

## OpenAI Account Quota

Account:        user@example.com (team)

3-hour limit
██████████████████████████████ 85% remaining
Resets in: 2h 30m

## Zhipu AI Account Quota

Account:        9c89****AQVM (Coding Plan)

5-hour token limit
██████████████████████████████ 95% remaining
Used: 0.5M / 10.0M
Resets in: 4h

## Z.ai Account Quota

Account:        9c89****AQVM (Z.ai)

5-hour token limit
██████████████████████████████ 95% remaining
Used: 0.5M / 10.0M
Resets in: 4h

## GitHub Copilot Account Quota

Account:        GitHub Copilot (individual)

Premium        ████░░░░░░░░░░░░░░░░ 24% (229/300)

Quota resets: 19d 0h (2026-02-01)

## Google Cloud Account Quota

### user@gmail.com

G3 Pro     4h 59m     ████████████████████ 100%
G3 Image   4h 59m     ████████████████████ 100%
G3 Flash   4h 59m     ████████████████████ 100%
Claude     2d 9h      ░░░░░░░░░░░░░░░░░░░░ 0%

Features

  • Query quota usage across multiple AI platforms in one command
  • Visual progress bars showing remaining quota
  • Reset time countdown
  • Multi-language support (Chinese / English)
  • Multiple Google Cloud accounts support
  • API key masking for security

Configuration

No additional configuration required. The plugin automatically reads credentials from:

  • OpenAI, Zhipu AI, Z.ai & GitHub Copilot: ~/.local/share/opencode/auth.json
  • Google Cloud: ~/.config/opencode/antigravity-accounts.json

Google Cloud Setup

To query Google Cloud (Antigravity) account quota, you need to install the opencode-antigravity-auth plugin first to authenticate your Google account.

Security

This plugin is safe to use:

Local Files Accessed (read-only):

  • ~/.local/share/opencode/auth.json - OpenCode's official auth storage
  • ~/.config/opencode/antigravity-accounts.json - Antigravity plugin's account storage

API Endpoints (all official):

  • https://chatgpt.com/backend-api/wham/usage - OpenAI official quota API
  • https://bigmodel.cn/api/monitor/usage/quota/limit - Zhipu AI official quota API
  • https://api.z.ai/api/monitor/usage/quota/limit - Z.ai official quota API
  • https://api.github.com/copilot_internal/user - GitHub Copilot official API
  • https://oauth2.googleapis.com/token - Google official OAuth API
  • https://cloudcode-pa.googleapis.com/v1internal:fetchAvailableModels - Google Cloud official API

Privacy:

  • No data is stored, uploaded, or cached by this plugin
  • Sensitive information (API keys) is automatically masked in output
  • Source code is fully open for review

Google Cloud Models

The plugin displays quota for these models:

Display Name Model Key
G3 Pro gemini-3-pro-high / gemini-3-pro-low
G3 Image gemini-3-pro-image
G3 Flash gemini-3-flash
Claude claude-opus-4-5-thinking / claude-opus-4-5

Development

# Using npm
npm install
npm run typecheck
npm run build

# Or using Bun
bun install
bun run typecheck
bun run build

License

MIT