# Turn Usage: Hermes Agent plugin

> Usage and cost footer appended to every reply — tokens, cache hit rate, cost and context occupancy, plus a per-tool time breakdown showing which tool actually consumed the wall clock.

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

Usage and cost footer appended to every reply — tokens, cache hit rate, cost and context occupancy, plus a per-tool time breakdown showing which tool actually consumed the wall clock. Waiting time (a blocking user prompt) is reported separately and excluded from the active-time denominator. Pure computation, never calls a model; any failure leaves the reply untouched.

## Good to know before installing

The usage footer is appended to the stored assistant reply, so it is replayed to the model on later turns and adds tokens to every turn.

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 turn-usage
```

2. Said no? Turn it on later:

```bash
hermes plugins enable turn-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: Coding & developer tools
- Maintained by: tpte (Community)
- Needs: No API keys declared
- In the catalog since: 2026-10-02

## Links

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