# Error Ledger: Hermes Agent plugin

> Local ledger of failed provider calls (rate limits, overloads, timeouts, context overflows): /errors shows how many attempts failed per model, provider or cause, how many Hermes could retry, and the most common HTTP…

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

Local ledger of failed provider calls (rate limits, overloads, timeouts, context overflows): /errors shows how many attempts failed per model, provider or cause, how many Hermes could retry, and the most common HTTP status, for the last 24 hours, any number of hours or days, the latest session or everything recorded; /errors days puts one day on each line, newest first; /errors recent lists the newest failures (ten, or up to 100 with /errors recent 50) and how long ago each happened.

## Good to know before installing

Writes failed-attempt metadata (ids, provider, model, HTTP status, Hermes's failure class, exception class name, timings; no error message, request or prompt text) to plugin-data/error-ledger/errors.jsonl, trimmed to 5,000 rows past 2 MB; no network

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 error-ledger
```

2. Said no? Turn it on later:

```bash
hermes plugins enable error-ledger
```

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: olric3015 (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.21.5`
- Version: 1.3.0
- In the catalog since: 2026-10-06, updated 2026-10-13

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/error-ledger)
- [Source code](https://github.com/olric3015/hermes-plugins/tree/main/error-ledger)
- [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