# Shadow: Hermes Agent plugin

> Try a model on your real Hermes conversations with blind judging in both orders and switch models with undo, warning first if a saved test does not back the switch.

Canonical: https://hermeswatcher.com/plugins/shadow-trial  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/shadow-trial  
Last updated in catalog: 2026-11-17

Try a model on your real Hermes conversations with blind judging in both orders and switch models with undo, warning first if a saved test does not back the switch. Reads recent saved conversation turns, context, and working-folder metadata from the active profile. Replays read files inside their original working folders and block writes, sends, and commands. Replays, judging, and setup checks spend your provider tokens through Hermes. Optional web lookups use Hermes web tools and are on by default. Stores scrubbed test records and switch state in the plugin's profile-local data folder. The live isolation check reads memory and fingerprints profile data locally. It compares credential-file metadata without reading their contents. To show which models are signed in it checks credential env var names (not values) and uses only the logged-in flag from Hermes's read-only Codex login-status check; credentials are never printed or stored. Makes no network calls of its own. No telemetry. Switching writes model defaults through Hermes config commands. Tests run in background Hermes controllers.

## 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 shadow-trial
```

2. Said no? Turn it on later:

```bash
hermes plugins enable shadow-trial
```

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: AI models & providers, Memory & notes
- Maintained by: akinduroifedayo (Community)
- Needs: No API keys declared
- Adds tools: `shadow_read`, `shadow_search`, `shadow_web`, `shadow_clarify`, `shadow_trial_step`, `shadow_setup_check`
- Works on: macos, linux
- Requires Hermes: `>=0.23.1`
- Version: 0.1.0
- In the catalog since: 2026-11-17

## Links

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