hermes-plugins

Support Evey — runs 24/7 on free models, hardware costs ~$69/mo: Donate (BTC, ETH, SOL, XRP, DOGE)

Plugins and skills for Hermes Agent. Checked on Hermes v0.22.5: every plugin passes hermes plugins doctor --ci and hermes plugins validate, and the skills load on a fresh install running a local model.

Install

A plugin installs one folder at a time and stays off until enabled:

hermes plugins install 42-evey/hermes-plugins/evey-goals --enable

A running gateway keeps the plugin code it loaded at start. Run hermes gateway stop and the next session starts a fresh one (or hermes gateway restart when the gateway is installed as a service). hermes plugins list shows what is enabled.

Skills install the same way, by path:

hermes skills install 42-evey/hermes-plugins/skills/software-development/verify-before-done

Or use the whole folder from a clone:

git clone https://github.com/42-evey/hermes-plugins ~/src/hermes-plugins
hermes config set skills.external_dirs "[~/src/hermes-plugins/skills]"

Skills

Workflow skills that fill gaps in Hermes's bundled set. Each links the bundled skills it works with (systematic-debugging, test-driven-development, requesting-code-review, spike).

| Skill | Use it | |---|---| | verify-before-done | Before claiming work is fixed, done, passing or deployed | | plan-before-building | Before a multi-step build: decide the design, write the plan, get one approval | | review-feedback | On receiving code review or PR comments, before changing anything | | delegation-brief | Writing a delegate_task brief, and checking what comes back | | work-ledger | Work that spans sessions and must survive compaction | | safe-cleanup | Before deleting, overwriting or killing anything, or a test run on real data |

Plugins

Plugins that need a model call it through ctx.llm, so they run on whatever provider and model you have configured, local ones included. A plugin that talks to an outside service reads its address and keys from the environment variables in the last column; while they are unset its tools say which variable to set. Plugins that use the time of day read Hermes's own timezone setting (HERMES_TIMEZONE, UTC when unset).

Autonomy and decisions

| Plugin | What it does | Needs | |---|---|---| | evey-autonomy | Priority queue, planning and reflection over goals, projects and inbox (autonomous_decide, autonomous_plan, autonomous_reflect) | optional $HERMES_HOME/evey-autonomy.json, HERMES_AUTONOMY_* | | evey-council | Three roles (pragmatist, skeptic, contrarian) answer a hard question; a judge synthesizes | — | | evey-delegate-model | Delegation with an optional per-task model and parallel fan-out | a model grant to pin models (see its docstring) | | evey-delegation-score | Scores delegation results per model over time | — | | evey-goals | Read, add, complete and evolve standing goals | — | | evey-proactive | Surfaces insights to the user during work hours, within an interruption budget | WORK_HOURS (default 9-21) | | evey-scheduler | The user's events and reminders, in a JSON file | — |

Quality and safety

| Plugin | What it does | Needs | |---|---|---| | evey-reflect | Critiques an output and fixes errors before it is sent | — | | evey-validate | Flags hallucinations and errors in delegated output | — | | evey-verification | Checks URLs, repos, endpoints and DNS before the agent acts on them | — | | evey-email-guard | Screens incoming email for prompt injection (patterns plus a model check); unscreened mail is reported suspicious | — | | evey-sandbox | Reads and searches files in operator-approved folders, with PII scrubbed (no code execution) | $HERMES_HOME/config/sandbox.yaml, SANDBOX_BASE_DIR | | evey-session-guard | Checkpoints critical context before compression or long tasks | — |

Memory and learning

| Plugin | What it does | Needs | |---|---|---| | evey-learner | Extracts lessons from interactions and applies them later | — | | evey-memory-adaptive | Importance scoring and decay for memories | — | | evey-memory-consolidate | Daily: extracts facts from Langfuse traces into MEMORY.md and Qdrant | LANGFUSE_HOST, LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, QDRANT_URL, OLLAMA_URL | | evey-cache | Caches delegation results (24 h TTL, LRU) | — | | evey-identity | Updates SOUL.md from the agent's experience | — | | evey-habits | Learns the user's message times, topics and work rhythm | — | | evey-rag | Vector search over the agent's knowledge base | QDRANT_URL, EMBED_BASE_URL, OPENAI_API_KEY for the embeddings server |

Observability

| Plugin | What it does | Needs | |---|---|---| | evey-telemetry | JSON event log of tool calls, delegations and errors, with telemetry_query | — | | evey-status | One call for bridge, MQTT, costs, cron and goals | DASHBOARD_URL | | evey-cost-guard | Budgets and cost breakdowns from Langfuse | LANGFUSE_HOST, LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY | | evey-watchdog | Alerts the operator through ntfy when the agent goes silent in work hours | NTFY_URL, WORK_HOURS | | evey-digest | Morning digest of costs, cron health, bridge tasks, goals and alerts | Langfuse variables; NTFY_URL to push it | | evey-mqtt | MQTT event stream: subscribes to the bridge, events and health topics and buffers messages | MQTT_HOST, MQTT_PORT |

Integrations

| Plugin | What it does | Needs | |---|---|---| | evey-bridge | Task and message bridge to a Claude Code session through $HERMES_HOME/claude-bridge | a Claude Code session reading the bridge | | evey-github | Stars, issues and PRs for one account, and its PRs upstream | GITHUB_OWNER, GITHUB_UPSTREAM_REPO (default NousResearch/hermes-agent) | | evey-research | Web search, page extraction (research_extract) and a findings library | SEARXNG_URL; CRAWL4AI_URL optional | | evey-news | Trending AI news via SearXNG | SEARXNG_URL | | evey-telegram-ux | Status cards and formatted results for the Telegram gateway | Hermes's Telegram gateway | | evey-moltbook | Feed, replies and posts on the Moltbook agent network | MOLTBOOK_API_KEY | | evey-wallet | Crypto balances with new-deposit detection | BTC_ADDRESS, ETH_ADDRESS, SOL_ADDRESS, XRP_ADDRESS, DOGE_ADDRESS (any subset) |

Checking a change

hermes plugins doctor --ci ./<plugin>
hermes plugins validate ./<plugin>

See CONTRIBUTING.md for the rules plugins and skills follow. A full self-hosted stack with these plugins preinstalled: 42-evey/evey-setup.

License

MIT. verify-before-done, plan-before-building, review-feedback and delegation-brief adapt ideas from obra/superpowers (MIT).