Hermes

ベンダー： Hermes インストール名： hermes ステータス： プレビュー ネイティブ設定： ~/.hermes/config.yaml

インストールCopy Anchor Link

apothem install --harness hermes

アダプターは共有プロファイルを Hermes Agent のユーザーグローバル設定ファイルへ変換し、Apothem のサポートコホートをハーネスルート配下にインストールします。

書き込まれるファイル： ~/.hermes/config.yaml、プロファイルドキュメント ~/.hermes/apothem/rules/00-apothem-profile.md、および ~/.hermes/.apothem/support/ 配下のサポートファイル

プロファイルドキュメントは、Apothem サポートファイルのセクションで終わります。 このセクションは、リポジトリ形式の各参照（rules/<name>.md、templates/...、hooks/...）が解決される先の、~/.hermes/.apothem/support/ 配下の絶対ディレクトリを示します。

プロファイルからネイティブ設定へのマッピングCopy Anchor Link

アダプターは Apothem の共有プロファイルを読み取り、プロファイルの MCP インベントリを含む ネイティブの YAML 設定をレンダリングします。MCP サーバーは、プロファイルの mcp_servers セクションから取得されます。ファイルとしてコピーされるのではなく、インストールと更新のたびに config.yaml へレンダリングされます。アダプターはまた、Hermes が読む追加のスキルディレクトリの リストである skills.external_dirs に ~/.hermes/.apothem/support/skills を追加します。これにより Hermes はインストールされたスキルを見つけます。このエントリーは、あなたがすでに列挙している エントリーの後に置かれ、あなたの他のキーはそのまま残ります。プロファイルのアイデンティティ、 プリファレンス、ルールはプロファイルドキュメントに入ります。共有のコマンド、スキル、ヘルパー定義、ルール、テンプレート、 フックプロンプトは、サポート資料として ~/.hermes/.apothem/support/ 配下に配置されます。

互換性に関する注意Copy Anchor Link

プレビュー版のアダプターです。 Hermes は skills.external_dirs を通じて Apothem のスキルを読み込みますが、サポートツリーの残りの部分もプロファイルドキュメントも自ら読み込みません。config.yaml 内の他のどの設定も、Hermes が読み取るどのコンテキストファイルもそこを指していないため、インストール後の Hermes は Apothem のルールとフックなしで動作します。

名前の衝突。 Hermes はスキルについて次の優先順位を文書化しています：プロジェクトのスキル（<project>/.hermes/skills/ と <project>/.agents/skills/）、次に ~/.hermes/skills/、次に skills.create_dir、次に skills.external_dirs 配下に列挙されたフォルダーです。 Apothem のディレクトリは external_dirs のエントリーなので、最後になります。 確認した Hermes のドキュメントは、2 つの場所に同じ名前のスキルがある場合に Hermes がどちらのコピーを読み込むかを述べていません。Apothem はこの順序を先の場所が勝つものと解釈しているため、先の場所にあなたが置いている同じ名前のスキルが Apothem のコピーより優先されると考えてください。 Apothem は config.yaml と ~/.hermes/.apothem/support/ 配下にのみ書き込み、それより前の場所には決して書き込まないため、インストール、更新、アンインストールが、あなたがそこに置いているスキルを置き換えることはありません。

apothem update は、skills.config やあなた自身の skills.external_dirs のエントリーを含め、あなたが config.yaml に追加したキーを保持します。 アダプターはプロファイルの MCP インベントリを、Hermes が MCP サーバーを読み取るトップレベルの mcp_servers キーの下に書き込みます。 以前の Apothem リリースはそれを auxiliary.mcp の下に書き込んでいましたが、Hermes はこれを MCP ツールのディスパッチ用の補助モデルとして読み取ります。apothem update と apothem uninstall はどちらも、そのブロックが、そうしたリリースがあなたの現在の共有プロファイルから書き込むであろう内容と一致している場合は、そのブロックを削除します（そのブロックが残る場合についてはアンインストールを参照）。 （Hermes の振る舞いは、Hermes のユーザーガイドのスキル（2026-10-24 に参照）と MCP（2026-10-02 に参照）に関するページに基づきます。）

config.yaml 内のコメント。 Apothem は、コメントを削除する YAML ライブラリでファイルを書き直します。 ファイルにあなたのコメントが含まれていてエントリーがない場合、Apothem はファイルに手を付けず、インストールはそのキーを挙げるメッセージを出して停止します。 エントリーを自分で追加してから、再度インストールを実行してください。

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

あなたが自分で追加したエントリーはあなたのものとみなされます。このディレクトリをすでに列挙している場合、Apothem はあなたのエントリーをそのまま保持し、アンインストールはそれをそのまま残します。

検証Copy Anchor Link

apothem verify --harness hermes

verify コマンドは次のことを確認します。

1. ネイティブ設定が想定されたパスに存在すること。
2. 管理対象の各ターゲットが存在すること。管理対象のファイルは空ではなく、JSON または YAML の設定は解析できること。--profile PATH を追加すると、インストールされたファイルがそのプロファイルと一致することも確認します。
3. ネイティブ設定の skills.external_dirs に ~/.hermes/.apothem/support/skills が記載されていること。そのエントリーがないと Hermes はインストールされたスキルを読み込みません。apothem update がそれを再び追加します。
4. アダプター固有の検証ルーチンが成功を報告すること。

更新Copy Anchor Link

apothem update --harness hermes

現在の共有プロファイルの状態からネイティブ設定を再導出します。skills.external_dirs 内の Apothem のエントリーは、何度更新しても 1 回だけ記載されたままです。 ~/.config/apothem/profile.yaml を編集した後、またはインストール済みの Apothem パッケージをアップグレードした後に実行してください。

アンインストールCopy Anchor Link

apothem uninstall --harness hermes

アダプターが追加したものを削除します。対象は、インストールが config.yaml に記録した mcp_servers のエントリと skills.external_dirs のエントリ（あなた自身の external_dirs のエントリや skills.config を含め、あなた自身のキーは残り、ファイルが削除されるのは Apothem がそれを作成し、かつあなたのものが何も残っていない場合のみです）、プロファイルドキュメント、およびサポートツリーです。 共有プロファイルの YAML と Apothem エンジンには影響しません。

以前のリリースが作成したインストール（プロファイルのサーバーを auxiliary.mcp の下に書き込んでいたもの）でも、そのブロックは、~/.config/apothem/profile.yaml にあるあなたの現在の共有プロファイルから、そのリリースが書き込むであろう内容と一致している場合に削除されます。 これは apothem update が適用するのと同じルールであるため、先に更新せずにアンインストールしても、プロファイルの MCP サーバーが変わっていない間は、古いブロックは残りません。 あなたが編集したブロック、あなたの現在のプロファイルの MCP サーバーとはもはや一致しないブロック、または比較対象となる読み取り可能な共有プロファイルがないブロックはそのまま残り、auxiliary のそれ以外の設定は常に残ります。

コンフォーミティゲートCopy Anchor Link

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

トラブルシューティングCopy Anchor Link

設定ノブCopy Anchor Link

関連項目Copy Anchor Link

• すべてのハーネス — サポート対象ツールの完全なカタログ
• インストールガイド — このハーネスに Apothem をインストールする
• apothem harnesses リファレンス — CLI からアダプターを一覧表示して調べる