Lean Quota Monitor

One status bar. All your AI quotas.

Lean Quota Monitor is a VS Code AI usage and quota monitor for Codex, Claude Code, GitHub Copilot, Gemini / Antigravity, MiniMax, Kimi, GLM, OpenRouter, OpenCode Go, DeepSeek, and Devin.

Track subscription usage limits, remaining quota, reset times, and credits directly in the VS Code Status Bar. Provider acquisition currently supports Linux / Remote WSL, native Windows (Beta), and macOS partial Beta Extension Hosts. macOS currently supports Codex, AGY, and Copilot; Claude subscription quota is not enabled there because Claude Code stores its credentials in macOS Keychain.

GPT 99% 1w 6d │ AGY 98% 1w 3d │ M3 99% 1w 23h │ OR $74.75

Quota providers show the remaining percentage, window type (5h, 1d, 1w, 1m), and reset countdown. Credit providers show Remaining Credit. Each quota provider presents one window at a time — its Primary Window (the longest duration by default). When any other window drops to or below the Low Quota Warning Threshold (default 20%, or off), the Status Bar preempts to that window with a ⚠️ marker (e.g. ⚠️ GPT 15% 5h 12m) until it recovers.

Built-in Providers

Exact acquisition and normalization contracts live in docs/provider-acquisition-spec.md.

Using the monitor

Clicking the Status Bar opens the monitor — a single menu with everything:

Built-in / Custom providers
→ current value · window · visibility
→ per-provider refresh button
→ click a provider: show or hide · rename · status-bar name
  · API key · primary window · troubleshoot (when errored)

Menu actions
→ Add Custom Provider
→ Refresh Interval
→ ⚠️ Low Quota Warning Threshold
→ Status Bar Alignment
→ Troubleshoot Providers

Hover shows the full per-window breakdown plus Refresh All, Quick Configure, Settings, Troubleshoot, reorder arrows, and show/hide controls.

Provider setup

For first-time setup of extension-owned keys, if the Provider is not visible, open Troubleshoot, choose the Provider and its setup method, then use the direct Set / Replace Key action. Once the Provider is working, open the monitor and choose the Provider to replace its key or change its display settings — including the Primary Window shown on the Status Bar.

The raw key is stored in VS Code SecretStorage; it is not written to normal settings or logs.

Codex, Claude, Copilot, AGY, and Devin reuse their existing local login/CLI authority (or GitHub Token for Copilot). Troubleshoot shows the actual file or executable lookup used by the current Extension Host.

Detailed recovery behavior is documented in docs/troubleshooting.md.

Custom Providers

Custom Providers are lightweight local status sources:

Monitor menu
→ Add Custom Provider

Each Custom Provider has:

Provider Name
Status Bar Name
Script Path

The extension executes the Script Path directly with no shell command/argument parser. The script must exit successfully and write exactly one non-empty logical line to stdout. That line becomes the opaque Status Output.

echo '$12.30'

The Status Bar renders Status Bar Name + Status Output with a maximum combined length of 10 Unicode characters. Lean Quota Monitor does not infer quota, credit, currency, percentage, or other semantics from Custom Status Output. Custom Provider credentials remain owned by the script.

Generic examples are available under examples/custom-provider/.

Security

SECURITY.md

Contributing

• Human contributors: CONTRIBUTING.md
• Autonomous AI contributors: docs/contribution-prompt.md

Buy me a coffee ❤️

GitHub Sponsors