Puppetmaster Learn

From its catalog listing

Turns a Puppetmaster swarm into a Hermes skill. Puppetmaster runs durable worker jobs (swarms and flow graphs) for an agent. When a Hermes session ends, this plugin finds the swarm that finished during that session in the session's directory and, if it produced findings or a patch, writes its goal and findings (title, location, severity, failure scenario, evidence) as a skill candidate under $HERMES_HOME/skills-candidates/. Promote it with `puppetmaster skills promote-candidate <slug>`. It never writes a live skill or starts an agent or job, and writes one candidate per job. Needs the Puppetmaster CLI (PyPI puppetmaster-ai).

Good to know before installing

at session end it reads the ending session's cwd and started_at from the Hermes session store (read-only, no messages), runs up to three read-only Puppetmaster CLI commands (last --json, status, artifacts) as child processes in that directory, 15 s timeout each, stdin closed, and reads the mcp_servers.puppetmaster entry of Hermes config.yaml (no credentials); it writes only under $HERMES_HOME/skills-candidates/; no network, no threads or background processes, no telemetry, no dependencies beyond the standard library.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install puppetmaster-learn
  2. Said no? Turn it on later:
    hermes plugins enable puppetmaster-learn
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Automation & multi-agent
Maintained by
professorpalmer (Community)
Needs
No API keys declared
Adds hooks
on_session_finalize
Needs Hermes
0.20.4 or newer
Version
0.2.1
In the catalog
2026-11-14

Known issues (from its catalog listing)

  • Gateway-owned sessions (hermes -z, TUI, desktop) drop plugin session-end messages today, so the notice does not show. The candidate is still written; `puppetmaster skills list-candidates` lists it.
  • Only the latest Puppetmaster job of the session's directory is checked. If two swarms finish in one session, only the later one becomes a candidate.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in automation & multi-agent

All automation & multi-agent plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins