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
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install plan-usage - Said no? Turn it on later:
hermes plugins enable plan-usage - 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

Full setup & settings ↗Source code ↗
More in security & privacy
All security & privacy plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher