Hermes

Anbieter: Hermes Installationsname: hermes Status: Vorschau Native Konfiguration: ~/.hermes/config.yaml

InstallationCopy Anchor Link

apothem install --harness hermes

Der Adapter übersetzt das gemeinsame Profil in die benutzerweite globale Konfigurationsdatei von Hermes Agent und installiert die Apothem-Unterstützungskohorten unter dem Harness-Wurzelverzeichnis.

Geschriebene Dateien: ~/.hermes/config.yaml, das Profildokument ~/.hermes/apothem/rules/00-apothem-profile.md und Unterstützungsdateien unter ~/.hermes/.apothem/support/

Das Profildokument endet mit einem Abschnitt zu den Apothem-Unterstützungsdateien, der das absolute Verzeichnis unter ~/.hermes/.apothem/support/ nennt, gegen das jeder Verweis im Repository-Stil (rules/<name>.md, templates/..., hooks/...) aufgelöst wird.

Zuordnung von Profil zu nativer KonfigurationCopy Anchor Link

Der Adapter liest das gemeinsame Profil von Apothem und rendert die native YAML-Konfiguration einschließlich des MCP-Inventars des Profils. Die MCP-Server stammen aus dem Abschnitt mcp_servers des Profils. Sie werden bei jeder Installation und jedem Update in config.yaml gerendert, nicht als Dateien kopiert. Der Adapter fügt außerdem ~/.hermes/.apothem/support/skills zu skills.external_dirs hinzu, der Liste zusätzlicher Skill-Verzeichnisse, die Hermes liest; so findet Hermes die installierten Skills. Der Eintrag kommt nach allen Einträgen, die Sie bereits aufführen, und Ihre übrigen Schlüssel bleiben, wie sie sind. Identität, Präferenzen und Regeln des Profils gehen in das Profildokument. Gemeinsame Commands, Skills, Helfer-Definitionen, Regeln, Templates und Hook-Prompts landen als Unterstützungsmaterial unter ~/.hermes/.apothem/support/.

KompatibilitätshinweiseCopy Anchor Link

Vorschau-Adapter. Hermes lädt die Apothem-Skills über skills.external_dirs, lädt aber weder den Rest des Unterstützungs-Teilbaums noch das Profildokument von selbst: Nichts sonst in config.yaml und keine der Kontextdateien, die Hermes liest, verweist dorthin, daher läuft Hermes nach der Installation ohne die Regeln oder Hooks von Apothem.

Namenskonflikte. Hermes dokumentiert diese Vorrangreihenfolge für Skills: die Skills des Projekts (<project>/.hermes/skills/ und <project>/.agents/skills/), dann ~/.hermes/skills/, dann skills.create_dir, dann die unter skills.external_dirs aufgeführten Ordner. Das Apothem-Verzeichnis ist ein external_dirs-Eintrag und kommt daher zuletzt. Die geprüfte Hermes-Dokumentation sagt nicht, welche Kopie Hermes lädt, wenn zwei Orte einen gleichnamigen Skill enthalten; Apothem liest die Reihenfolge so, dass frühere Orte gewinnen, rechnen Sie also damit, dass ein gleichnamiger Skill, den Sie an einem früheren Ort halten, Vorrang vor der Apothem-Kopie hat. Apothem schreibt nur in config.yaml und unter ~/.hermes/.apothem/support/, nie in diese früheren Orte, daher ersetzen Installation, Aktualisierung und Deinstallation keinen Skill, den Sie dort halten.

apothem update behält Schlüssel bei, die Sie zu config.yaml hinzufügen, einschließlich skills.config und Ihrer eigenen skills.external_dirs-Einträge. Der Adapter schreibt das MCP-Inventar des Profils unter den Top-Level-Schlüssel mcp_servers, wo Hermes MCP-Server liest. Frühere Apothem-Releases schrieben es unter auxiliary.mcp, das Hermes als Hilfsmodell für den Dispatch von MCP-Werkzeugen liest; sowohl apothem update als auch apothem uninstall entfernen diesen Block, wenn er noch dem entspricht, was ein solches Release aus Ihrem aktuellen gemeinsamen Profil schreiben würde (siehe Deinstallation, wann er stehen bleibt). (Verhalten von Hermes gemäß den Seiten seines Benutzerhandbuchs zu Skills, gelesen am 2026-10-24, und MCP, gelesen am 2026-10-02.)

Kommentare in config.yaml. Apothem schreibt die Datei mit einer YAML-Bibliothek neu, die Kommentare verwirft. Enthält die Datei Kommentare von Ihnen und fehlt der Eintrag, lässt Apothem die Datei unverändert, und die Installation bricht mit einer Meldung ab, die den Schlüssel nennt. Fügen Sie den Eintrag selbst hinzu und führen Sie dann die Installation erneut aus:

skills:
  external_dirs:
    - ~/.hermes/.apothem/support/skills

Ein Eintrag, den Sie selbst hinzufügen, gilt als Ihrer: Wenn Sie dieses Verzeichnis bereits aufführen, behält Apothem Ihren Eintrag unverändert bei, und die Deinstallation lässt ihn bestehen.

VerifizierungCopy Anchor Link

apothem verify --harness hermes

Der Befehl verify bestätigt Folgendes:

1. Die native Konfiguration existiert am erwarteten Pfad.
2. Jedes verwaltete Ziel existiert; verwaltete Dateien sind nicht leer, und JSON- oder YAML-Konfigurationen lassen sich parsen. Fügen Sie --profile PATH hinzu, um außerdem zu bestätigen, dass die installierten Dateien zu diesem Profil passen.
3. skills.external_dirs in der nativen Konfiguration führt ~/.hermes/.apothem/support/skills auf. Ohne diesen Eintrag lädt Hermes die installierten Skills nicht; apothem update fügt ihn wieder hinzu.
4. Die adapterspezifische Verifizierungsroutine meldet Erfolg.

AktualisierungCopy Anchor Link

apothem update --harness hermes

Leitet die native Konfiguration aus dem aktuellen Zustand des gemeinsamen Profils neu ab; der Apothem-Eintrag in skills.external_dirs bleibt genau einmal aufgeführt, wie oft Sie auch aktualisieren. Führen Sie den Befehl aus, nachdem Sie ~/.config/apothem/profile.yaml bearbeitet oder das installierte Apothem-Paket aktualisiert haben.

DeinstallationCopy Anchor Link

apothem uninstall --harness hermes

Entfernt, was der Adapter hinzugefügt hat: die mcp_servers-Einträge und den skills.external_dirs-Eintrag, die seine Installation in config.yaml festgehalten hat (Ihre eigenen Schlüssel bleiben erhalten, einschließlich Ihrer eigenen external_dirs-Einträge und skills.config, und die Datei wird nur gelöscht, wenn Apothem sie erstellt hat und nichts von Ihnen übrig ist), das Profildokument und den Unterstützungs-Teilbaum. Die YAML-Datei des gemeinsamen Profils und die Apothem-Engine bleiben unberührt.

Bei einer Installation durch ein früheres Release, das die Server des Profils unter auxiliary.mcp schrieb, wird dieser Block ebenfalls entfernt, wenn er noch dem entspricht, was dieses Release aus Ihrem aktuellen gemeinsamen Profil unter ~/.config/apothem/profile.yaml schreiben würde. Dies ist dieselbe Regel, die apothem update anwendet, sodass eine Deinstallation ohne vorheriges Update keinen veralteten Block hinterlässt, solange die MCP-Server des Profils unverändert sind. Ein Block, den Sie bearbeitet haben, einer, der nicht mehr zu den MCP-Servern Ihres aktuellen Profils passt, oder einer, für den kein lesbares gemeinsames Profil zum Vergleich vorliegt, bleibt an Ort und Stelle, und der Rest Ihrer auxiliary-Einstellungen bleibt immer erhalten.

Konformitäts-GateCopy Anchor Link

python -m apothem.conformity.gate --all .

FehlerbehebungCopy Anchor Link

KonfigurationsschalterCopy Anchor Link

Siehe auchCopy Anchor Link

• Alle Harnesses — der vollständige Katalog der unterstützten Werkzeuge
• Installationsanleitung — Apothem in diesen Harness installieren
• Referenz zu apothem harnesses — Adapter über die CLI auflisten und untersuchen