Hermes

Proveedor: Hermes Nombre de instalación: hermes Estado: Vista previa Configuración nativa: ~/.hermes/config.yaml

InstalaciónCopy Anchor Link

apothem install --harness hermes

El adaptador traduce el perfil compartido al archivo de configuración global de usuario de Hermes Agent e instala las cohortes de soporte de Apothem bajo la raíz del entorno.

Archivos escritos: ~/.hermes/config.yaml, el documento de perfil ~/.hermes/apothem/rules/00-apothem-profile.md y archivos de soporte bajo ~/.hermes/.apothem/support/

El documento de perfil termina con una sección de archivos de soporte de Apothem que nombra el directorio absoluto bajo ~/.hermes/.apothem/support/ contra el que se resuelve cada cita con estilo de repositorio (rules/<name>.md, templates/..., hooks/...).

Asignación del perfil a la configuración nativaCopy Anchor Link

El adaptador lee el perfil compartido de Apothem y renderiza la configuración YAML nativa, incluido el inventario MCP del perfil. Los servidores MCP provienen de la sección mcp_servers del perfil. Se renderizan en config.yaml en cada instalación y actualización, en lugar de copiarse como archivos. El adaptador también añade ~/.hermes/.apothem/support/skills a skills.external_dirs, la lista de directorios de skills adicionales que lee Hermes, que es como Hermes encuentra las skills instaladas. La entrada va después de las entradas que ya listes, y tus demás claves se quedan como están. La identidad, las preferencias y las reglas del perfil van al documento de perfil. Los comandos, las skills, las definiciones de ayudantes, las reglas, las plantillas y los prompts de hook compartidos terminan como material de soporte bajo ~/.hermes/.apothem/support/.

Notas de compatibilidadCopy Anchor Link

Adaptador en vista previa. Hermes carga las skills de Apothem a través de skills.external_dirs, pero no carga por sí mismo el resto del árbol de soporte ni el documento de perfil: nada más en config.yaml ni ninguno de los archivos de contexto que lee Hermes apunta allí, así que después de la instalación Hermes se ejecuta sin las reglas ni los hooks de Apothem.

Conflictos de nombres. Hermes documenta este orden de precedencia para las skills: las skills del proyecto (<project>/.hermes/skills/ y <project>/.agents/skills/), luego ~/.hermes/skills/, luego skills.create_dir y luego las carpetas listadas bajo skills.external_dirs. El directorio de Apothem es una entrada de external_dirs, así que va el último. La documentación de Hermes revisada no indica qué copia carga Hermes cuando dos ubicaciones contienen una skill del mismo nombre; Apothem interpreta el orden como que ganan las ubicaciones anteriores, así que cabe esperar que una skill del mismo nombre que conserves en una ubicación anterior tenga precedencia sobre la copia de Apothem. Apothem solo escribe en config.yaml y bajo ~/.hermes/.apothem/support/, nunca en esas ubicaciones anteriores, así que la instalación, la actualización y la desinstalación no reemplazan una skill que conserves allí.

apothem update conserva las claves que agregues a config.yaml, incluidas skills.config y tus propias entradas de skills.external_dirs. El adaptador escribe el inventario MCP del perfil bajo la clave de nivel superior mcp_servers, donde Hermes lee los servidores MCP. Los lanzamientos anteriores de Apothem lo escribían bajo auxiliary.mcp, que Hermes lee como el modelo auxiliar para el despacho de herramientas MCP; tanto apothem update como apothem uninstall eliminan ese bloque cuando sigue coincidiendo con lo que escribiría uno de esos lanzamientos a partir de tu perfil compartido actual (consulta Desinstalación para saber cuándo se conserva). (Comportamiento de Hermes según las páginas de su guía de usuario sobre skills, consultada el 2026-10-24, y MCP, consultada el 2026-10-02.)

Comentarios en config.yaml. Apothem reescribe el archivo con una biblioteca YAML que descarta los comentarios. Cuando el archivo contiene comentarios tuyos y falta la entrada, Apothem deja el archivo intacto y la instalación se detiene con un mensaje que nombra la clave. Añade tú mismo la entrada y luego vuelve a ejecutar la instalación:

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

Una entrada que añades tú mismo cuenta como tuya: si ya listas este directorio, Apothem conserva tu entrada tal cual y la desinstalación la deja en su sitio.

VerificaciónCopy Anchor Link

apothem verify --harness hermes

El comando verify confirma que:

1. La configuración nativa existe en la ruta esperada.
2. Cada destino gestionado existe; los archivos gestionados no están vacíos y las configuraciones JSON o YAML se analizan correctamente. Añade --profile PATH para confirmar también que los archivos instalados coinciden con ese perfil.
3. skills.external_dirs en la configuración nativa lista ~/.hermes/.apothem/support/skills. Sin esa entrada, Hermes no carga las skills instaladas; apothem update la vuelve a añadir.
4. La rutina de verificación específica del adaptador informa de éxito.

ActualizaciónCopy Anchor Link

apothem update --harness hermes

Vuelve a derivar la configuración nativa a partir del estado actual del perfil compartido; la entrada de Apothem en skills.external_dirs sigue listada una sola vez por muchas veces que actualices. Ejecútalo después de editar ~/.config/apothem/profile.yaml o de actualizar el paquete de Apothem instalado.

DesinstalaciónCopy Anchor Link

apothem uninstall --harness hermes

Elimina lo que agregó el adaptador: las entradas de mcp_servers y la entrada de skills.external_dirs que su instalación registró en config.yaml (tus propias claves se conservan, incluidas tus propias entradas de external_dirs y skills.config, y el archivo se elimina solo cuando Apothem lo creó y no queda nada tuyo en él), el documento de perfil y el árbol de soporte. El YAML del perfil compartido y el motor de Apothem no se ven afectados.

En una instalación hecha por un lanzamiento anterior, que escribía los servidores del perfil bajo auxiliary.mcp, también se elimina ese bloque cuando sigue coincidiendo con lo que escribiría ese lanzamiento a partir de tu perfil compartido actual en ~/.config/apothem/profile.yaml. Es la misma regla que aplica apothem update, así que desinstalar sin actualizar antes no deja ningún bloque obsoleto mientras los servidores MCP del perfil no cambien. Un bloque que hayas editado, uno que ya no coincide con los servidores MCP de tu perfil actual, o uno sin un perfil compartido legible con el que compararlo, se queda en su lugar, y el resto de tus ajustes de auxiliary siempre se conserva.

Puerta de conformidadCopy Anchor Link

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

Solución de problemasCopy Anchor Link

Opciones de configuraciónCopy Anchor Link

Véase tambiénCopy Anchor Link

• Todos los entornos — el catálogo completo de herramientas compatibles
• Guía de instalación — instala Apothem en este entorno
• Referencia de apothem harnesses — lista e inspecciona adaptadores desde la CLI