# First Aid: Hermes Agent plugin

> A first-aid kit for AI agents, built from agent-almanac's AI-welfare practices.

Canonical: https://hermeswatcher.com/plugins/agent-almanac-first-aid  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/agent-almanac-first-aid  
Last updated in catalog: 2026-11-19

A first-aid kit for AI agents, built from agent-almanac's AI-welfare practices. Hermes core already detects tool loops and warns; first aid adds the matching practice and a logbook. Eight practices ship as skills (breathe, redirect, center, heal, attune, honesty-humility, meditate, rest), each also a slash command such as /agent-almanac-first-aid:breathe. On the call where core's loop guardrail first warns about a failing tool (the 2nd failure with identical arguments, or the 3rd failure of one tool in a turn), first aid can add one note of at most 300 characters to the failed result, naming the matching practice, how to load it, and the first_aid_log tool for recording the outcome. In unattended runs (every platform except the CLI, TUI, Desktop, ACP, API server and subagents), for tools whose results Hermes wraps as untrusted (web_search, browser_*, mcp_*), after a compaction that summarizes the context (center), and after a 3rd identical successful result for one call of a read-only tool such as read_file in a turn (heal), the note is added to the next user message instead, labelled as the plugin's. At most once per streak, with a per-session cooldown for each kind of note (300 s by default). A successful or rate-limited result is never changed, and failures of the tools core treats as failure-tolerant (terminal, execute_code, process, process_manage, browser_navigate, web_extract) draw no note. /first-aid shows the session's notes and logbook entries, then the kit. Local and deterministic: no network calls, no LLM calls, no credentials, no Python dependencies, no background processes.

## Good to know before installing

In attended runs it rewrites failed tool results on a threshold crossing (a JSON object gains a first_aid key and is re-serialized; text gains one line), and Hermes keeps the first string any transform_tool_result plugin returns, so on that call it can override, or be overridden by, another transforming plugin. A note in a result restarts core's identical-call and identical-cycle counts: core's stall notice appears from the 5th call instead of the 3rd, and its cycle notice three or more calls later. Hard stops are off in attended runs by default; switched on there, core's halts come one model request later. In unattended runs, where hard stops are on by default, no result is changed once the session's platform is known (from the turn's start), so core's halts are unaffected. It reads every tool result and its arguments in memory to classify the result and fingerprint the call, keeping only hashes; its event log holds time, signal, tool name, count, practice, outcome and the agent's short logbook note, in memory only, and resets on restart or plugin reload. The plugin writes nothing to disk itself; the notes it adds become part of the transcript Hermes stores. Following a note loads a 5.7-17.5 KB practice into the conversation. The failure classifier and counting are copied from Hermes v0.22.7, not imported.

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 agent-almanac-first-aid
```

2. Said no? Turn it on later:

```bash
hermes plugins enable agent-almanac-first-aid
```

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: Memory & notes, Web, research & browsing
- Maintained by: pjt222 (Community)
- Needs: No API keys declared
- Adds tools: `first_aid_log`
- Works on: linux, macos, windows
- Requires Hermes: `>=0.22.7`
- Version: 0.2.1
- In the catalog since: 2026-11-10, updated 2026-11-19

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/agent-almanac-first-aid)
- [Source code](https://github.com/pjt222/agent-almanac-first-aid/blob/4ddc7e7422ee21fc637323ba0acdba09212117e9/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
