同梱のプラグイン

Hermes には、リポジトリと一緒に配られる小さなプラグインの一式が入っています。置き場所は <repo>/plugins/<name>/ で、~/.hermes/plugins/ に自分で入れたプラグインと並んで自動的に読み込まれます。フック、ツール、スラッシュコマンドという仕組みは他社製のプラグインとまったく同じで、違いは Hermes 本体の中で手入れされている点だけです。

プラグインの仕組み全体は プラグイン のページを、自分で書きたいときは Hermes プラグインを作る を見てください。

見つけ方の仕組み

PluginManager は次の4か所を、この順番で調べます。

1. 同梱 — <repo>/plugins/<name>/（このページで説明しているもの）
2. 利用者 — ~/.hermes/plugins/<name>/
3. プロジェクト — ./.hermes/plugins/<name>/（HERMES_ENABLE_PROJECT_PLUGINS=1 が必要）
4. pip のエントリーポイント — hermes_agent.plugins

名前がぶつかったときは後から見つかったほうが勝ちます。つまり disk-cleanup という名前の利用者プラグインを置けば、同梱のものが差し替わります。

plugins/memory/ と plugins/context_engine/ は、同梱の探索対象からわざと外してあります。記憶の提供元と文脈エンジンは1つだけ選ぶ形の仕組みで、設定の hermes memory setup や context.engine から選ぶため、これらのディレクトリは別の経路で見つけられます。

同梱プラグインは自分で有効にする

同梱プラグインは無効の状態で配られます。探索では見つかるので hermes plugins list や対話的な hermes plugins の画面には出てきますが、自分ではっきり有効にするまでは1つも読み込まれません。

hermes plugins enable disk-cleanup

~/.hermes/config.yaml から指定することもできます。

plugins:
  enabled:
    - disk-cleanup

これは自分で入れたプラグインとまったく同じ仕組みです。同梱プラグインが勝手に有効になることはありません。新しく入れたときも、すでに使っている環境を新しい Hermes に上げたときもです。いつでも自分の意思で有効にします。

同梱プラグインをまた止めたいときはこうします。

hermes plugins disable disk-cleanup
# or: remove it from plugins.enabled in config.yaml

現在同梱されているもの

リポジトリの plugins/ には次の同梱プラグインが入っています。どれも自分で有効にする形なので、hermes plugins enable <name> で使えるようにしてください。

記憶の提供元（plugins/memory/*）と文脈エンジン（plugins/context_engine/*）は 記憶の提供元 に別立てで載せてあります。前者は hermes memory、後者は hermes plugins から扱います。ここから先は、長く動き続けるフック型の2つについて、プラグインごとに詳しく見ていきます。

disk-cleanup

セッション中にできたその場限りのファイル — 試し書きのスクリプト、一時的な出力、定期実行のログ、古くなった chrome のプロファイル — を自動で覚えておき、消してくれます。エージェントが「片づけのツールを呼ぶ」ことを覚えておかなくても済みます。

動き方:

消す条件:

スラッシュコマンド — /disk-cleanup は CLI とゲートウェイのどちらのセッションでも使えます。

/disk-cleanup status                     # breakdown + top-10 largest
/disk-cleanup dry-run                    # preview without deleting
/disk-cleanup quick                      # run safe cleanup now
/disk-cleanup deep                       # quick + list items needing confirmation
/disk-cleanup track <path> <category>    # manual tracking
/disk-cleanup forget <path>              # stop tracking (does not delete)

状態 — すべて $HERMES_HOME/disk-cleanup/ の下にあります。

安全のために — 片づけが手をつけるのは HERMES_HOME か /tmp/hermes-* の下だけです。Windows のマウント先（/mnt/c/...）は受け付けません。よく知られた最上位の状態ディレクトリ（logs/、memories/、sessions/、cron/、cache/、skills/、plugins/、そして disk-cleanup/ 自身）は、たとえ空でも消しません。入れたばかりの環境が最初のセッションの終わりに中身をさらわれることはありません。

有効にする: hermes plugins enable disk-cleanup（hermes plugins の画面でチェックを入れても構いません）。

また止める: hermes plugins disable disk-cleanup。

security-guidance

ファイルの書き込みに対して、型の照合で素早くセキュリティの注意を出します。エージェントの write_file／patch／skill_manage が運ぶ中身に、危ないと分かっているコードの型 — pickle.load、SafeLoader なしの yaml.load、eval(、os.system、subprocess(..., shell=True)、JavaScript の child_process.exec、React の dangerouslySetInnerHTML、生の .innerHTML =／.outerHTML =／document.write、Node の crypto.createCipher、AES の ECB モード、TLS の検証を切っているもの、XXE を招きやすい xml.etree／minidom の解析器、SRI のない <script src="//..." >、weights_only=True のない torch.load、GitHub Actions の ${{ github.event.* }} の差し込み — が含まれていると、ツールの結果に ⚠️ Security guidance の一節を書き足します。

ファイル自体は書き込まれます。モデルは次のターンでツールのメッセージとしてその警告を読み、コードを直すか、その書き方がこの場面では安全である理由を書き残すかを選べます。型の照合はどうしても見当違いの警告が出ることがあり、だからこそ既定は「止める」ではなく「知らせる」になっています。

守備範囲: 全25ルール。安全でない復元、コマンドの差し込み、XSS の出口、暗号の落とし穴、XXE、供給網（SRI）、CI/CD のワークフローへの差し込みをまかないます。型のデータは Anthropic の claude-plugins-official を Apache-2.0 のまま丸ごと取り込んだもので、出どころの表示はプラグインの LICENSE と NOTICE を見てください。

動き方の切り替え:

有効にする: hermes plugins enable security-guidance（hermes plugins の画面でチェックを入れても構いません）。

また止める: hermes plugins disable security-guidance。

まだできないこと: 元になった Anthropic のプラグインには、さらに2つの層があります。ファイルに触れたエージェントのターンごとに差分を LLM が見直す層と、コミットの時点でファイルをまたいでデータの流れを追う層です。どちらもまだ移していません。エージェント自身は delegate_task を使って、必要なときにその見直しを走らせられます。

observability/langfuse

Hermes のターン、LLM の呼び出し、ツールの実行を Langfuse に記録します。Langfuse は LLM の様子を見るためのオープンソースの基盤です。1ターンにつき1つの区間、API 呼び出しごとに1つの生成、ツール呼び出しごとに1つの観測が残ります。使用量の合計、種類ごとのトークン数、費用の見積もりは Hermes 本来の agent.usage_pricing の数字をそのまま使うので、Langfuse の画面には hermes logs と同じ内訳（入力／出力／cache_read_input_tokens／cache_creation_input_tokens／reasoning_tokens）が出ます。

このプラグインは、うまくいかないときは黙って通す作りです。SDK が入っていない、資格情報がない、Langfuse が一時的に不調 — どの場合もフックの中で何もせずに終わります。エージェントの動きが妨げられることはありません。

設定（対話的に進める。こちらがおすすめです）:

hermes tools          # → Langfuse Observability → Cloud or Self-Hosted

案内役が鍵を聞き取り、langfuse の SDK を pip install し、plugins.enabled に observability/langfuse を書き加えてくれます。Hermes を立ち上げ直せば、次のターンから記録が送られます。

設定（自分で進める）:

pip install langfuse
hermes plugins enable observability/langfuse

続いて ~/.hermes/.env に資格情報を書きます。

HERMES_LANGFUSE_PUBLIC_KEY=pk-lf-...
HERMES_LANGFUSE_SECRET_KEY=sk-lf-...
HERMES_LANGFUSE_BASE_URL=https://cloud.langfuse.com   # or your self-hosted URL

動き方:

セッションのまとめ方は、langfuse.propagate_attributes を通して Hermes のセッション ID（下請けのエージェントならタスク ID）に合わせてあります。おかげで hermes chat の1回のセッションで起きたことは、Langfuse でも1つのセッションの下に集まります。

確かめる:

hermes plugins list                 # observability/langfuse should show "enabled"
hermes chat -q "hello"              # check the Langfuse UI for a "Hermes turn" trace

細かい調整（.env に書きます）:

Hermes を頭に付けた名前と、SDK が本来使う名前（LANGFUSE_PUBLIC_KEY、LANGFUSE_SECRET_KEY、LANGFUSE_BASE_URL）のどちらも使えます。両方あるときは Hermes を頭に付けたほうが優先されます。

速さについて: Langfuse の接続先は最初のフック呼び出しのあと使い回されます。資格情報や SDK がないと分かった場合も、その判断が覚えられます。以降のフックは環境変数を調べ直したり設定を読み直したりせず、すぐに戻ります。

止める: hermes plugins disable observability/langfuse。プラグイン自体は見つかったままですが、また有効にするまで中のコードは1行も動きません。

NeMo Relay の本体組み込み（移行にあたって）

NeMo Relay は、もう Hermes に同梱されるプラグインではありません。hermes plugins enable observability/nemo_relay は実行しないでください。Relay のセッション、ターン、LLM、ツールの流れは Hermes 本体が受け持つようになりました。

Relay の中間処理や書き出しを使いたいときは、Relay の標準的な plugins.toml を作り、Hermes を立ち上げる前に HERMES_NEMO_RELAY_PLUGINS_TOML でそのファイルを指してください。この決まりは、その Hermes のプロセスが抱えるすべてのプロファイルに一括で効きます。ATOF、ATIF、OpenTelemetry の選び方は NeMo Relay observability configuration を見てください。

以前の HERMES_NEMO_RELAY_ATOF_* と HERMES_NEMO_RELAY_ATIF_* の設定では、もう書き出しは始まりません。代わりの plugins.toml が選ばれていない場合、hermes doctor がこの古い設定を知らせます。

セッションの区間を区切る（ずっと続くセッション向け）

Relay は、区間の範囲が閉じたときにそれを書き出します。ゲートウェイのセッションはずっと続くことがあり、ターンごとの区間は普通に書き出されても、セッションの区間だけが何日も開いたままになりがちです。区切りの設定を使うと、ターンの切れ目でセッションの範囲だけを入れ替えられます。

gateway:
  telemetry:
    session_segments:
      on_compaction: false  # rotate after context compaction
      max_turns: 0          # 0 = unlimited; N = turns per segment

どちらの既定値でも、セッションの範囲はまるごと1つのままです。入れ替わった区間は同じ session_id を保ったまま、hermes.session.segment と hermes.session.segment_reason（compaction か max_turns）が加わります。

google_meet

エージェントが Google Meet の通話に参加し、書き起こし、話に加わる ためのものです。会議の内容を書き留め、終わったあとにやり取りをまとめ、気になった点を追いかけ、さらに望むなら TTS で通話に声を返すこともできます。

加わるもの:

• ブラウザの自動操作で Meet の URL に入る、画面を持たない仮想の参加者
• 設定された音声認識の提供元による、会議の音声のその場での書き起こし
• 通話に入り、書き起こしを随時取り出し、聞いた内容をもとに動くための meet_join／meet_status／meet_transcript／meet_leave／meet_say の道具立て
• 会議のあとに残る成果物（書き起こし、状態）。~/.hermes/workspace/meetings/<meeting_id>/ に保存されます

設定:

hermes plugins enable google_meet
hermes meet setup   # preflight: playwright, chromium, auth file
hermes meet auth    # opens a browser to sign into Google and saves session state —
                    # needs a Google account with Meet access. Host approval may be
                    # required if the meeting enforces "only invited participants can join".

チャットからはこう頼みます。

> 「meet.google.com/abc-defg-hij に入って内容を書き留めておいて。終わったら、やることの一覧を付けてまとめを送って。」

エージェントは会議への参加を始め、通話が進むあいだ書き起こしを自分の文脈へ取り込み続け、会議が終わったとき（あるいは止めるように言われたとき）に整ったまとめを作ります。

どんなときに使うか: 参加できなかった人のために、定例の進捗確認を書き起こしてまとめておきたいとき。聞き取り調査のように、整った記録がほしいとき。そのほか Fireflies や Otter、Grain を使うことになりそうな場面です。AI に聞かれたくない場では、有効にしないでください。

止める: hermes plugins disable google_meet。保存された書き起こしは、自分で消すまで ~/.hermes/workspace/meetings/ に残ります。

hermes-achievements

Steam 風の実績タブをダッシュボードに足します。実際の Hermes のセッション履歴から作られる、段位付きの収集バッジが60種類以上あります。ツールの連携技、デバッグの型、勢いに乗ったコーディングの連続記録、スキルや記憶の使い方、モデルや提供元の幅広さ、生活のくせ（週末や夜のセッション）まで。もとは @PCinkusz さんが外部のプラグインとして作ったもので、Hermes の機能の変化と足並みをそろえるために本体へ取り込まれました。

動き方:

• ダッシュボードの裏側で ~/.hermes/state.db のセッション履歴をすべて調べます
• セッションごとの集計は (started_at, last_active) の指紋で覚えておくので、次に調べるときは新しいものと変わったものだけを見直します
• 初めての集計は裏の処理として走ります。セッションが何千件ある場合でも、ダッシュボードがそれを待って止まることはありません
• 解放した記録は $HERMES_HOME/plugins/hermes-achievements/state.json に残ります

段位の進み方: Copper → Silver → Gold → Diamond → Olympian。それぞれのカードには「What counts」という欄があり、何を数えているのかがそのまま書いてあります。

実績の状態:

API — 経路は /api/plugins/hermes-achievements/ の下にあります。

状態のファイル — $HERMES_HOME/plugins/hermes-achievements/ の下にあります。

速さについて:

• 8,000 件ほどのセッションを初めて調べると数分かかります。ダッシュボードへの最初の要求で裏の処理として走り、画面は待機中の表示を出しながら /scan-status を見に行きます。
• 初回の集計中も途中経過が出ます — 250 件ほど進むごとに途中までの結果が公開されるので、画面を更新するたびに解放済みのバッジが増えていきます。何分もゼロを眺めることはありません。
• 2回目以降は、started_at と last_active の指紋が控えと一致するセッションの集計を使い回すので、履歴が大きくても数秒で終わります。
• 手元に持っている結果の有効期間は120秒です。過ぎていても古い結果をすぐ返し、裏で新しくします。期限が切れたというだけで待たされることはありません。

有効にする: 何もしません。hermes-achievements はダッシュボードだけのプラグインで、節目のフックもモデルから見えるツールも持ちません。hermes dashboard を最初に立ち上げたときに、自分でタブとして登録します。plugins.enabled の設定が効くのは節目やツールを持つプラグインだけで、ダッシュボードのプラグインは dashboard/manifest.json だけを頼りに見つけられます。

使わないようにする: plugins/hermes-achievements/dashboard/manifest.json を消すか名前を変えるか、~/.hermes/plugins/hermes-achievements/ に同じ名前でダッシュボードを持たない利用者プラグインを置いて上書きしてください。$HERMES_HOME/plugins/hermes-achievements/ の状態のファイルは残るので、入れ直せば解放の記録もそのままです。

同梱プラグインを足すには

同梱プラグインの書き方は、ほかの Hermes プラグインとまったく同じです — Hermes プラグインを作る を見てください。違うのは次の点だけです。

• 置き場所が ~/.hermes/plugins/<name>/ ではなく <repo>/plugins/<name>/ になる
• hermes plugins list では、出どころが bundled と表示される
• 同じ名前の利用者プラグインがあれば、そちらが同梱のものより優先される

同梱にふさわしいのは、こんなプラグインです。

• 追加の依存がない（あっても pip install .[all] にすでに含まれている）
• そのふるまいが多くの人の役に立ち、止めたい人だけが止める形になっている
• エージェントがいちいち呼ぶことを覚えておかないといけない処理を、節目のフックに任せられる
• モデルから見えるツールを増やさずに、本体の機能を補える

反対に、同梱にせず自分で入れてもらうべきものもあります。API キーが要る他社サービスとの連携、限られた場面でしか使わない流れ、依存が大きく膨らむもの、そして既定のままでエージェントのふるまいを大きく変えてしまうものです。