Plan Usage

From its catalog listing

Plan usage across providers in the Hermes Desktop status bar: a named chip per Claude and ChatGPT/Codex account in Hermes's credential pool (5-hour and weekly windows from Hermes's own usage cache via model.options, a default-account star and 90% / fallback warnings that name the next account), Nous Portal credits, and month-to-date (UTC) API spend from optional Anthropic / OpenAI Admin keys. Preferences are a Settings -> Plugins page.

Good to know before installing

its own network calls go only to api.anthropic.com/v1/organizations/cost_report and api.openai.com/v1/organization/costs, and only with the optional ANTHROPIC_ADMIN_KEY / OPENAI_ADMIN_KEY config_schema secrets read through get_secret, with redirects refused; Nous credits come from Hermes's build_credits_view (Hermes makes the Portal request); never reads or sends a subscription token, never opens .env or auth.json; writes only its own settings in plugin-data, the shown-warning ids in Desktop plugin storage, and, on an explicit star click, the credential-pool order through CredentialPool.move_entry; no subprocesses, no telemetry.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install plan-usage
  2. Said no? Turn it on later:
    hermes plugins enable plan-usage
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Security & privacy · Hermes Desktop add-ons
Maintained by
ziadelboshy (Community)
Needs
No API keys declared
Needs Hermes
0.23.0 or newer
Version
0.2.0
In the catalog
2026-11-10

Known issues (from its catalog listing)

  • Claude windows at exactly 1% used can show as 100% (and warn): Hermes core reads Anthropic's utilization as a 0-1 fraction. Plan Usage shows what Hermes reports. Upstream issue NousResearch/hermes-agent#145660 (fix PRs #139916 and #145663, both open).
  • Usage rows are matched to pool accounts by label in pool order; give each account its own --label so two accounts are never confused.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in security & privacy

All security & privacy plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins