Openrouter Balance

From its catalog listing

Live OpenRouter credit balance in the Hermes desktop status bar — "OR $12.34 left", with total/used/remaining on hover, amber below 15% remaining, click to refetch. Polls every 5 minutes idle and refetches ~8 s after each chat turn. The plugin's Python half resolves the profile's OPENROUTER_API_KEY through agent.secret_scope (profile-scope aware, safe under multiplexing; the key never leaves the backend) and proxies the free openrouter.ai /api/v1/credits endpoint, mounted at /api/plugins/openrouter-balance/* behind the dashboard auth gate. The desktop half registers a statusBar.right chip via @hermes/plugin-sdk. The Python register() is a no-op — no tools, hooks or middleware.

Good to know before installing

the only network egress is the openrouter.ai credits call authenticated with the user's own key; no telemetry; no file reads outside Hermes's own env resolution; no shell commands or background processes. Honest error chips (no key / bad key / offline / error) instead of silent failures; offline retries every 2 minutes.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs OPENROUTER_API_KEY), then asks whether to turn it on.
    hermes plugins install openrouter-balance
  2. Said no? Turn it on later:
    hermes plugins enable openrouter-balance
  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
Hermes Desktop add-ons · Chat apps & voice
Maintained by
maeinomatic (Community)
Needs
OPENROUTER_API_KEY API key
Version
1.0.3
In the catalog
2026-11-14
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 hermes desktop add-ons

All hermes desktop add-ons plugins

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

← All plugins