# Aegis Spend Guard: Hermes Agent plugin

> Owner-set spend policy for Hermes Agent, enforced in a pre_tool_call hook before any spend executes.

Canonical: https://hermeswatcher.com/plugins/aegis-spend-guard  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/aegis-spend-guard  
Last updated in catalog: 2026-11-18

Owner-set spend policy for Hermes Agent, enforced in a pre_tool_call hook before any spend executes. The owner configures a per-transaction cap, a daily limit, recipient allow/blocklists, a spend-tool scope and a warn zone (default 80% of a limit). Every tool call that spends money — an explicit amount in its arguments, a fixed per-call price from the owner's paid_tools map, a spend-shaped tool with no readable price, or a spend written into command/script text the agent is about to run (a money literal alongside a payment verb; on by default, the owner can turn the script gate off) — is evaluated by a worst-wins policy engine (BLOCK > WARN > ALLOW across frozen, amount, blocklist, per-transaction cap, daily limit, allowlist and tool-scope checks, the same semantics as the author's Aegis spend-control contract on Base and the tgp-guard pre-flight guard). Over-policy spends are vetoed with the reason; borderline spends return the approve directive and are routed to the owner through Hermes's own human-approval gate — the plugin never approves anything itself. Executed spends are recorded in a per-profile daily ledger held in ctx.state, and a /spendguard slash command gives the owner status plus a persistent freeze/unfreeze kill switch. Two tools (spend_guard_check, spend_guard_status) let the agent dry-run a planned spend and report guard state.

## Good to know before installing

No Python dependencies, no network calls, no shell commands, no credentials read or stored, no telemetry; the only writes are the plugin's own ctx.state keys (freeze flag, daily total). Known limit, disclosed in the README: parallel spend calls are each checked against the ledger as it stands before either executes, so a simultaneous burst can overshoot the daily limit by one call.

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 aegis-spend-guard
```

2. Said no? Turn it on later:

```bash
hermes plugins enable aegis-spend-guard
```

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: Security & privacy, Work & business
- Maintained by: georgeonweb3 (Community)
- Needs: No API keys declared
- Adds tools: `spend_guard_check`, `spend_guard_status`
- Requires Hermes: `>=0.23.0`
- Version: 1.1.2
- In the catalog since: 2026-11-11, updated 2026-11-18

## Links

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