# MySwarm: Hermes Agent plugin

> Discover, visualize, sanitize/export, and import community agents.md swarm configurations.

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

Discover, visualize, sanitize/export, and import community agents.md swarm configurations. Outputs abbreviated agent/persona/goal tables, renders ASCII topology diagrams (.svg and .png images + portable 7-bit copy-paste ASCII symbol blocks), generates rich themed swarm illustrations across 12 curated signature themes and orthogonal intensity levels (understated, normal, overstated) via Hermes default model and image_generate, exports sanitized agents.md files, and imports/reverts shared configs with on-screen file preview and best-effort import warnings; every import/revert asks for approval.

## Good to know before installing

Myswarm_import/myswarm_revert replace the workspace AGENTS.md/agents.md (a file Hermes loads into every session's system prompt) after a Hermes approval prompt; choosing "always" approves all later imports. The import security check is a best-effort regex + model warning, not a security boundary — only import files you trust. Swarm file contents are sent to your configured model for parsing and PII scrubbing (also best-effort; review exports before sharing), and myswarm_visualize_image calls your configured image_generate provider (may cost credits). Adds a ~2.8k-character MySwarm guidance section to every session's system prompt. Writes myswarm-ascii.svg/.png and .md exports into the current folder (exports may overwrite an existing .md file there), plus a .agents.md.myswarm.orig sidecar, and keeps import backups under HERMES_HOME/plugin-data/myswarm/.

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 myswarm
```

2. Said no? Turn it on later:

```bash
hermes plugins enable myswarm
```

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: Hermes Desktop add-ons
- Maintained by: tomkubik (Community)
- Needs: No API keys declared
- Adds tools: `myswarm_list`, `myswarm_ascii`, `myswarm_visualize_image`, `myswarm_export`, `myswarm_import`, `myswarm_revert`
- Requires Hermes: `>=0.19.0`
- Version: 1.0.0
- In the catalog since: 2026-10-13

## Links

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