Hermes

Éditeur : Hermes Nom d'installation : hermes Statut : Préversion Configuration native : ~/.hermes/config.yaml

InstallationCopy Anchor Link

apothem install --harness hermes

L'adaptateur traduit le profil partagé vers le fichier de configuration globale utilisateur de Hermes Agent et installe les cohortes de support Apothem sous la racine de l'environnement.

Fichiers écrits : ~/.hermes/config.yaml, le document de profil ~/.hermes/apothem/rules/00-apothem-profile.md et les fichiers de support sous ~/.hermes/.apothem/support/

Le document de profil se termine par une section consacrée aux fichiers de support Apothem, qui nomme le répertoire absolu sous ~/.hermes/.apothem/support/ par rapport auquel se résout chaque citation de style dépôt (rules/<name>.md, templates/..., hooks/...).

Correspondance entre le profil et la configuration nativeCopy Anchor Link

L'adaptateur lit le profil partagé d'Apothem et rend la configuration YAML native, y compris l'inventaire MCP du profil. Les serveurs MCP proviennent de la section mcp_servers du profil. Ils sont rendus dans config.yaml à chaque installation et mise à jour, et non copiés sous forme de fichiers. L'adaptateur ajoute aussi ~/.hermes/.apothem/support/skills à skills.external_dirs, la liste des répertoires de skills supplémentaires que lit Hermes, ce qui permet à Hermes de trouver les skills installés. L'entrée est placée après les entrées que vous listez déjà, et vos autres clés restent telles quelles. L'identité, les préférences et les règles du profil vont dans le document de profil. Les commandes, skills, définitions d'auxiliaires, règles, templates et prompts de hooks partagés aboutissent comme matériel de support sous ~/.hermes/.apothem/support/.

Notes de compatibilitéCopy Anchor Link

Adaptateur en préversion. Hermes charge les skills d'Apothem via skills.external_dirs, mais ne charge pas de lui-même le reste de l'arborescence de support ni le document de profil : rien d'autre dans config.yaml et aucun des fichiers de contexte que lit Hermes n'y pointe ; après l'installation, Hermes s'exécute donc sans les règles ni les hooks d'Apothem.

Conflits de noms. Hermes documente cet ordre de priorité pour les skills : les skills du projet (<project>/.hermes/skills/ et <project>/.agents/skills/), puis ~/.hermes/skills/, puis skills.create_dir, puis les dossiers listés sous skills.external_dirs. Le répertoire d'Apothem est une entrée de external_dirs ; il vient donc en dernier. La documentation de Hermes consultée n'indique pas quelle copie Hermes charge lorsque deux emplacements contiennent un skill du même nom ; Apothem interprète l'ordre comme donnant l'avantage aux emplacements précédents : attendez-vous donc à ce qu'un skill du même nom que vous conservez dans un emplacement précédent ait priorité sur la copie Apothem. Apothem n'écrit que dans config.yaml et sous ~/.hermes/.apothem/support/, jamais dans ces emplacements précédents ; l'installation, la mise à jour et la désinstallation ne remplacent donc pas un skill que vous y conservez.

apothem update conserve les clés que vous ajoutez à config.yaml, y compris skills.config et vos propres entrées skills.external_dirs. L'adaptateur écrit l'inventaire MCP du profil sous la clé de premier niveau mcp_servers, où Hermes lit les serveurs MCP. Les publications antérieures d'Apothem l'écrivaient sous auxiliary.mcp, que Hermes lit comme le modèle auxiliaire chargé de répartir les appels d'outils MCP ; apothem update comme apothem uninstall retirent ce bloc lorsqu'il correspond encore à ce qu'une telle publication écrirait à partir de votre profil partagé actuel (voir Désinstallation pour les cas où il reste en place). (Comportement de Hermes d'après les pages de son guide utilisateur consacrées aux skills, consultée le 2026-10-24, et au MCP, consultée le 2026-10-02.)

Commentaires dans config.yaml. Apothem réécrit le fichier avec une bibliothèque YAML qui supprime les commentaires. Lorsque le fichier contient des commentaires de votre part et que l'entrée manque, Apothem laisse le fichier intact et l'installation s'arrête avec un message qui nomme la clé. Ajoutez vous-même l'entrée, puis relancez l'installation :

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

Une entrée que vous ajoutez vous-même compte comme la vôtre : si vous listez déjà ce répertoire, Apothem conserve votre entrée telle quelle et la désinstallation la laisse en place.

VérificationCopy Anchor Link

apothem verify --harness hermes

La commande verify confirme que :

1. La configuration native existe au chemin attendu.
2. Chaque cible gérée existe ; les fichiers gérés ne sont pas vides, et les configurations JSON ou YAML s'analysent correctement. Ajoutez --profile PATH pour vérifier en plus que les fichiers installés correspondent à ce profil.
3. skills.external_dirs dans la configuration native liste ~/.hermes/.apothem/support/skills. Sans cette entrée, Hermes ne charge pas les skills installés ; apothem update la rajoute.
4. La routine de vérification propre à l'adaptateur signale un succès.

Mise à jourCopy Anchor Link

apothem update --harness hermes

Redérive la configuration native à partir de l'état actuel du profil partagé ; l'entrée Apothem de skills.external_dirs reste listée une seule fois, quel que soit le nombre de mises à jour. Exécutez cette commande après avoir modifié ~/.config/apothem/profile.yaml ou mis à niveau le paquet Apothem installé.

DésinstallationCopy Anchor Link

apothem uninstall --harness hermes

Supprime ce que l'adaptateur a ajouté : les entrées mcp_servers et l'entrée skills.external_dirs que son installation a consignées dans config.yaml (vos propres clés restent, y compris vos propres entrées external_dirs et skills.config, et le fichier n'est supprimé que si Apothem l'a créé et qu'il ne contient plus rien de vous), le document de profil et l'arborescence de support. Le YAML du profil partagé et le moteur Apothem ne sont pas affectés.

Pour une installation effectuée par une publication antérieure, qui écrivait les serveurs du profil sous auxiliary.mcp, ce bloc est également retiré lorsqu'il correspond encore à ce que cette publication écrirait à partir de votre profil partagé actuel, situé à ~/.config/apothem/profile.yaml. C'est la même règle que celle qu'applique apothem update ; désinstaller sans mettre à jour au préalable ne laisse donc aucun bloc obsolète tant que les serveurs MCP du profil restent inchangés. Un bloc que vous avez modifié, un bloc qui ne correspond plus aux serveurs MCP de votre profil actuel, ou un bloc pour lequel aucun profil partagé lisible ne permet la comparaison, reste en place, et le reste de vos paramètres auxiliary est toujours conservé.

Portail de conformitéCopy Anchor Link

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

DépannageCopy Anchor Link

Paramètres de configurationCopy Anchor Link

Voir aussiCopy Anchor Link

• Tous les environnements — le catalogue complet des outils pris en charge
• Guide d'installation — installer Apothem dans cet environnement
• Référence de apothem harnesses — lister et inspecter les adaptateurs depuis la CLI