# Token Stats: Hermes Agent plugin

> Lifetime token usage page for Hermes Desktop: totals across every profile on the connected (local or remote) gateway, a per-model table (share, input/output, cache read and cache %, calls, tokens per call,…

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

Lifetime token usage page for Hermes Desktop: totals across every profile on the connected (local or remote) gateway, a per-model table (share, input/output, cache read and cache %, calls, tokens per call, measured speed, cost), API-equivalent cost and savings from free models, subscription plans and prompt caching, a provider and profile split, activity streaks and month-over-month trend, daily chart, and top tools, skills and background (aux) work; plus a status-bar lifetime chip.

## Good to know before installing

Read-only: calls the gateway's /api/analytics/models and /api/analytics/usage routes for each profile through the raw window.hermesDesktop.api bridge (no typed SDK helper exists for them), lists profiles and connections, and listens to message/usage events to time turns. Stores speed samples, a pruning ledger (so lifetime totals survive sessions.auto_prune) and the last loaded numbers in plugin storage, and reads an optional user-made archive.json from its own ctx.files data folder. Cost uses a bundled snapshot of models.dev list prices. No network calls of its own, no telemetry, no credentials.

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 token-stats
```

2. Said no? Turn it on later:

```bash
hermes plugins enable token-stats
```

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: Hermes Desktop add-ons, Cost, speed & monitoring
- Maintained by: amitamit10 (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.23.0`
- Version: 1.0.0
- In the catalog since: 2026-11-17

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/token-stats)
- [Source code](https://github.com/amitamit10/hermes-token-stats#readme)
- [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
