# Soft Halo Usage: Hermes Agent plugin

> 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.

Canonical: https://hermeswatcher.com/plugins/softhalo-usage  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/softhalo-usage  
Last updated in catalog: 2026-11-15

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 the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install softhalo-usage
```

2. Said no? Turn it on later:

```bash
hermes plugins enable softhalo-usage
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Cost, speed & monitoring, AI models & providers
- Maintained by: ahujat (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.13.0`
- Version: 0.1.0
- In the catalog since: 2026-11-15

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/softhalo-usage)
- [Source code](https://github.com/ahujat/softhalo-usage-hermes/blob/76810482d0d1a22e1f5cf889b5b9fb45593817de/README.md)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
