Hermes Quota: plugin for Hermes Agent

Per-provider quota, rate limits and reset times in Hermes Desktop and the CLI, read from a local cache

What Hermes Quota does

The plugin offers a status-bar chip, a docked pane, a /quota command and a hermes quota CLI. All of them read from a local cache, so the interface makes no network calls on each render, and hermes quota refresh updates the data. It shows model-specific quota windows and reset times when the vendor supplies them, and reports unavailable states plainly instead of guessing.

Additional Claude accounts are configured explicitly by directory and display label, such as Work or Personal, and appear as separate cards with no summed or invented allowances. Extra Claude accounts are opt-in and read-only: no refresh-token exchange, no credential write-back and no tokens in the display cache. Other providers may use opt-in browser or OS credential-store reads, which docs/providers.md discloses. The README notes that Python plugins are trusted host code, not sandboxed. On remote Desktop setups the widget goes on the computer running the app and the backend on the gateway.

Key features

Status-bar chip and docked pane with per-provider usage
/quota command and hermes quota CLI with refresh and status
Model-specific quota windows and reset times when vendors supply them
Separate, configurable cards for multiple Claude accounts
Local cache feeds the UI, so rendering makes no network calls

When to use it

Checking how much quota remains for each model provider before starting a long Hermes session
Tracking a work and a personal Claude account side by side
Seeing when a rate limit resets without leaving Hermes Desktop

Who it is for: Hermes Desktop and CLI users who work across several model providers and want to watch their limits.

How it fits with Hermes Agent

A Hermes plugin for Hermes Desktop and the Hermes CLI, installed from source and checked with hermes plugins doctor.

How to install Hermes Quota

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/rarf/hermes-quota-plugin.git
cd hermes-quota-plugin
./install.sh
hermes plugins doctor quota --ci

Note: The source installer enables quota for all existing profiles, so review that scope before running it.

FAQ

What is Hermes Quota?

Hermes Quota is a Hermes plugin that displays provider quotas, rate limits, reset times and account balances. It appears as a status-bar chip, a docked pane, a /quota command and a CLI.

Does Hermes Quota work with Hermes Agent?

Yes, it is a Hermes plugin for Hermes Desktop and the CLI. It checks itself with hermes plugins doctor quota --ci and reports through hermes quota status.

Is Hermes Quota free and open source?

Yes, the repository is released under the MIT license.