Hermes

Fornecedor: Hermes Nome de instalação: hermes Status: Prévia Configuração nativa: ~/.hermes/config.yaml

InstalaçãoCopy Anchor Link

apothem install --harness hermes

O adaptador traduz o perfil compartilhado para o arquivo de configuração global do usuário do Hermes Agent e instala os cohorts de suporte do Apothem sob a raiz do harness.

Arquivos gravados: ~/.hermes/config.yaml, o documento de perfil ~/.hermes/apothem/rules/00-apothem-profile.md e arquivos de suporte sob ~/.hermes/.apothem/support/

O documento de perfil termina com uma seção de arquivos de suporte do Apothem que nomeia o diretório absoluto sob ~/.hermes/.apothem/support/ em relação ao qual cada citação no estilo do repositório (rules/<name>.md, templates/..., hooks/...) é resolvida.

Mapeamento do perfil para a configuração nativaCopy Anchor Link

O adaptador lê o perfil compartilhado do Apothem e renderiza a configuração YAML nativa, incluindo o inventário de MCP do perfil. Os servidores MCP vêm da seção mcp_servers do perfil. Eles são renderizados em config.yaml a cada instalação e atualização, e não copiados como arquivos. O adaptador também adiciona ~/.hermes/.apothem/support/skills a skills.external_dirs, a lista de diretórios de skills extras que o Hermes lê, que é como o Hermes encontra as skills instaladas. A entrada vai depois de quaisquer entradas que você já liste, e as suas outras chaves permanecem como estão. A identidade, as preferências e as regras do perfil vão para o documento de perfil. Os comandos compartilhados, as skills, as definições de auxiliares, as regras, os templates e os prompts de hook chegam como material de suporte em ~/.hermes/.apothem/support/.

Notas de compatibilidadeCopy Anchor Link

Adaptador em prévia. O Hermes carrega as skills do Apothem por meio de skills.external_dirs, mas não carrega por conta própria o restante da árvore de suporte nem o documento de perfil: nada mais em config.yaml e nenhum dos arquivos de contexto que o Hermes lê aponta para lá, então, após a instalação, o Hermes é executado sem as regras nem os hooks do Apothem.

Conflitos de nome. O Hermes documenta esta ordem de precedência para skills: as skills do projeto (<project>/.hermes/skills/ e <project>/.agents/skills/), depois ~/.hermes/skills/, depois skills.create_dir e depois as pastas listadas em skills.external_dirs. O diretório do Apothem é uma entrada de external_dirs, então ele vem por último. A documentação do Hermes consultada não informa qual cópia o Hermes carrega quando dois locais contêm uma skill de mesmo nome; o Apothem interpreta a ordem como se os locais anteriores vencessem, então espere que uma skill de mesmo nome que você mantenha em um local anterior tenha precedência sobre a cópia do Apothem. O Apothem grava somente em config.yaml e sob ~/.hermes/.apothem/support/, nunca nesses locais anteriores, então a instalação, a atualização e a desinstalação não substituem uma skill que você mantenha ali.

apothem update mantém as chaves que você adiciona ao config.yaml, incluindo skills.config e as suas próprias entradas de skills.external_dirs. O adaptador grava o inventário MCP do perfil sob a chave de nível superior mcp_servers, onde o Hermes lê os servidores MCP. Lançamentos anteriores do Apothem o gravavam sob auxiliary.mcp, que o Hermes lê como o modelo auxiliar para o despacho de ferramentas MCP; tanto apothem update quanto apothem uninstall removem esse bloco quando ele ainda corresponde ao que um desses lançamentos gravaria a partir do seu perfil compartilhado atual (consulte Desinstalação para saber quando ele permanece). (Comportamento do Hermes conforme as páginas do seu guia do usuário sobre skills, lida em 2026-10-24, e MCP, lida em 2026-10-02.)

Comentários em config.yaml. O Apothem reescreve o arquivo com uma biblioteca YAML que descarta comentários. Quando o arquivo contém comentários seus e a entrada está ausente, o Apothem deixa o arquivo intacto e a instalação é interrompida com uma mensagem que nomeia a chave. Adicione você mesmo a entrada e depois execute a instalação novamente:

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

Uma entrada que você mesmo adiciona conta como sua: se você já lista este diretório, o Apothem mantém a sua entrada como está e a desinstalação a mantém no lugar.

VerificaçãoCopy Anchor Link

apothem verify --harness hermes

O comando verify confirma que:

1. A configuração nativa existe no caminho esperado.
2. Cada destino gerenciado existe; os arquivos gerenciados não estão vazios, e as configurações JSON ou YAML podem ser analisadas. Adicione --profile PATH para também confirmar que os arquivos instalados correspondem a esse perfil.
3. skills.external_dirs na configuração nativa lista ~/.hermes/.apothem/support/skills. Sem essa entrada, o Hermes não carrega as skills instaladas; apothem update a adiciona de volta.
4. A rotina de verificação específica do adaptador informa sucesso.

AtualizaçãoCopy Anchor Link

apothem update --harness hermes

Deriva novamente a configuração nativa a partir do estado atual do perfil compartilhado; a entrada do Apothem em skills.external_dirs continua listada uma única vez, não importa quantas vezes você atualize. Execute após editar ~/.config/apothem/profile.yaml ou atualizar o pacote do Apothem instalado.

DesinstalaçãoCopy Anchor Link

apothem uninstall --harness hermes

Remove o que o adaptador adicionou: as entradas de mcp_servers e a entrada de skills.external_dirs que sua instalação registrou em config.yaml (as suas próprias chaves permanecem, incluindo as suas próprias entradas de external_dirs e skills.config, e o arquivo só é excluído quando o Apothem o criou e nada seu resta nele), o documento de perfil e a árvore de suporte. O YAML do perfil compartilhado e o motor do Apothem não são afetados.

Uma instalação feita por um lançamento anterior, que gravava os servidores do perfil sob auxiliary.mcp, também tem esse bloco removido quando ele ainda corresponde ao que aquele lançamento gravaria a partir do seu perfil compartilhado atual em ~/.config/apothem/profile.yaml. Esta é a mesma regra que apothem update aplica, então desinstalar sem atualizar antes não deixa nenhum bloco obsoleto enquanto os servidores MCP do perfil não mudarem. Um bloco que você editou, um bloco que não corresponde mais aos servidores MCP do seu perfil atual, ou um bloco sem perfil compartilhado legível com o qual comparar, permanece no lugar, e o restante das suas configurações de auxiliary sempre permanece.

Conformity gateCopy Anchor Link

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

Solução de problemasCopy Anchor Link

Ajustes de configuraçãoCopy Anchor Link

Veja tambémCopy Anchor Link

• Todos os harnesses — o catálogo completo de ferramentas suportadas
• Guia de instalação — instale o Apothem neste harness
• Referência de apothem harnesses — liste e inspecione adaptadores pela CLI