# Context Audit: Hermes Agent plugin

> Context-window forensics: per-turn input/output token estimates, the single largest tool output of each turn, oversized tool calls (args over 50 KB), and compaction events, recorded as metadata only (tool name, byte…

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

Context-window forensics: per-turn input/output token estimates, the single largest tool output of each turn, oversized tool calls (args over 50 KB), and compaction events, recorded as metadata only (tool name, byte length, ids, timestamps — never args or results) in a local SQLite DB under HERMES_HOME/plugin-data/context-audit/. Adds a /context-audit slash command that prints the top 5 context eaters over a window with one mitigation per entry.

## 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 context-audit
```

2. Said no? Turn it on later:

```bash
hermes plugins enable context-audit
```

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
- Maintained by: ZidoCode (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.21.6`
- Version: 0.1.0
- In the catalog since: 2026-10-13

## Links

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