Soft Halo Usage

From its catalog listing

Shows your Hermes token usage in Soft Halo's always-on-top Windows overlay, which you can resize and make more or less transparent, next to Claude Code, Codex and OpenClaw. Observer hooks only: after each model call it writes the token counts (uncached input, cache reads and writes, output), the provider, model and session id to a small file in Soft Halo's local folder on Windows, reached from WSL through /mnt/c.

Good to know before installing

after every model call it writes a small file with token counts, provider, model and session id (never prompts, responses or tool output) into Soft Halo's local usage folder, which on WSL is the Windows user's AppData folder reached through /mnt/c; on a machine without Soft Halo those files are never cleaned up. No network requests and no tools or commands.

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 softhalo-usage
  2. Said no? Turn it on later:
    hermes plugins enable softhalo-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
Cost, speed & monitoring · AI models & providers
Maintained by
ahujat (Community)
Needs
No API keys declared
Adds hooks
post_api_request post_auxiliary_call
Needs Hermes
0.13.0 or newer
Version
0.1.0
In the catalog
2026-11-15

Known issues (from its catalog listing)

  • Needs Soft Halo for Windows 2.0.5.20 or later to show the numbers; without it the plugin only writes small local files.
  • On Hermes versions without the post_auxiliary_call hook (such as v0.13.0), side calls such as title generation are not counted.
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 cost, speed & monitoring

All cost, speed & monitoring plugins

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

← All plugins