hermes@agent:~/.hermes$ cat hermes.md

Hermes Agent:実践者のためのリファレンス(2026年)

# Nous Researchが開発するオープンソースの自己改善型AIエージェント、Hermes Agentの実践ガイドです。プロバイダー認証、設定ファイル、スキルシステムから、複数のプラットフォームに対応するメッセージングゲートウェイとしての運用まで解説します。

author: words: 8633 read_time: 303m updated: 2026-11-11 06:39
$ less hermes.md

要点: Hermes Agentは、Nous Researchが開発するオープンソースの自己改善型AIエージェントです。CLIとしても、複数のプラットフォームに対応するメッセージングgatewayとしても動作します。一貫したアイデンティティと永続的な記憶をディスクに保存し、使うほどに改善されるskillを蓄積します。OpenAI互換のLLMプロバイダーであれば、Nous Portal、OpenRouter、Anthropic、GitHub Copilot(v0.22.6のリリース時期以降はgithub-copilotプラグイン)、z.ai、Kimi、MiniMax、DeepSeek、Qwen Cloud、Hugging Face、Google、xAI/SuperGrok、独自にホストするエンドポイントのいずれでも利用できます。1219 現在のリリースはv0.22.6です(タグはv0.22.6、日付は2026年11月2日)。v0.22.2以降では4回目となる小規模な累積リリースにあたります。v0.22.2はv0.22.0に対する修正パッチの訂正版で、v0.22.0はv0.21.1からv0.21.7までの一連のパッチをすべて統合し、文書化した機能リリースです。v0.22.3からv0.22.6までの整理されたリリースノートは、v0.23.0に持ち越されています。v0.22.6の新機能、v0.22.3〜v0.22.5の新機能、v0.22.2の新機能、v0.22.1の新機能、v0.22.0の新機能で変更点を紹介しています。それ以降のリリースに関するセクションは、新しい順に並んでいます。5860626466 初めて使う方が最もつまずきやすいのは、プロバイダーの認証です。タグv0.22.5の時点で、Hermesの選択メニューには39のプロバイダーが静的に登録されており、同梱された41のプロバイダープラグインからその一覧が自動的に拡張されます。さらに、カスタムエンドポイント、v0.22.0で導入された管理機能付きのローカルllama.cppランタイム、3種類の認証経路(.envのAPIキー、hermes model経由のOAuth、config.yamlのカスタムエンドポイント)があります。53555961 まず理解すべきなのは、この認証の仕組みです。それ以外のすべては、どのプロバイダーが選択されるかによって決まります。

Hermes Agentは、チャットのラッパーではなく、本格的なエージェントランタイムとして動作します。 ファイルシステムの読み取り、サンドボックス化されたバックエンドでのコマンド実行、ウェブのスクレイピング、サブエージェントの起動、スケジュールされたcronジョブの実行に対応します。単一のgatewayプロセスからTelegram/Discord/Slack/WhatsApp/Signal/メールとやり取りでき、経験をもとに独自のskillも作成します。1 CLIは、run_agent.py内の会話ループを基盤とするターミナルUIです。gatewayは常駐プロセスとして動作し、メッセージングプラットフォームから届くメッセージを同じ会話ループに渡します。3

Hermesを気軽に使う段階から使いこなす段階へ進む鍵は、5つのシステムにあります。 これらを習得すれば、Hermesでできることが大きく広がります。

  1. プロバイダーの解決:認証フローがAPI呼び出しにどう結び付くか
  2. 設定の階層構造:config.yaml + .env + auth.json + SOUL.md + AGENTS.md
  3. ツール + toolsetの仕組み:エージェントが実行できる操作と、プラットフォームごとの利用制限
  4. skillの仕組み:エージェントが作成し、進化させる手続き記憶
  5. gateway + cron + profile:今開いている環境だけでなく、日常的に使う場所でHermesを動かす方法

重要なポイント

  • プロバイダーの認証経路は、1つではなく3つあります。 .envのAPIキー、hermes model/hermes auth経由のOAuth、config.yamlのカスタムエンドポイントです。使い慣れた方法ではなく、利用するプロバイダーに合った経路を選びましょう。
  • プロバイダーは1つのコマンドで切り替えられます。 hermes modelでは、OAuthログインを含め、対応するすべてのプロバイダーの設定を対話形式で進められます。/model provider:modelを使えば、履歴を失わずにセッションの途中で切り替えることもできます。2
  • ユーザーが設定を編集するためのファイルは2つです。 ~/.hermes/config.yamlには設定を、~/.hermes/.envにはシークレットを保存します。auth.json、SOUL.md、MEMORY.md、skills/はHermesが直接管理します。SOUL.mdは手動でも編集できますが、それ以外はエージェント自身が更新します。4
  • HermesはOpenClawの後継です。 移行する場合は、hermes claw migrateで30以上のカテゴリの状態を自動的にインポートできます。5 v0.22.5のリリース時期以降、移行機能はagent-importersプラグインが担っています。hermes claw migrateというコマンド表記はそのまま使え、Claude Code、Codex、Cursorの設定もインポートできます(CLIコマンドをご覧ください)。65
  • 補助タスクも、デフォルトではメインモデルを使います。 画像認識、承認判断の分類、圧縮、セッションタイトルの生成は、それぞれ独立した「補助」LLM呼び出しとして実行されます。このタグの時点では、autoを指定すると、これらすべてがメインのチャットモデルに振り分けられます。設定は不要ですが、高価な推論モデルを使う場合、こうした補助タスクのコストも無視できません。コストが気になる場合は、個々のauxiliary.<task>に安価で高速なモデルを指定してください。434

以下の各セクションは、開発元のドキュメントhermes-agent.nousresearch.com/docsとソースツリーgithub.com/NousResearch/hermes-agentに基づいています。事実に関する記述にはすべて、出典となる開発元の具体的なページを示す脚注を付けています。

目的に合ったセクションを選ぶ

やりたいこと 参照先
Hermesをインストールする インストール — 1行で実行できるインストーラー、または手動の手順
プロバイダーにサインインする 認証とプロバイダー — 認証のためにこのガイドを開いた方はこちら
セッションの途中でモデルを切り替える /modelの構文については、hermes authコマンドとカスタムエンドポイントとセルフホスト型エンドポイントをご覧ください
ローカルでLLMを動かす カスタムエンドポイントとセルフホスト型エンドポイント — Ollama、vLLM、SGLang、llama.cpp、LM Studio
メッセージングプラットフォームに接続する メッセージングgateway — Telegram、Discord、Slack、WhatsApp、Signal、Google Chat、LINE、SimpleX Chat、ntfy、Buzz(ドキュメントの比較表には28種類を掲載)
skillを作成・インストールする skillの仕組み — 段階的な情報開示 + skillハブ
すべてのCLIコマンドを詳しく調べる このまま読み進めるか、CLIコマンドへ直接移動してください

Hermesの仕組み:メンタルモデル

Hermesは、どのエントリーポイントからでも呼び出せる単一の会話ループを中心に構成されています。エントリーポイントには、CLI(cli.py)、メッセージングgateway(gateway/run.py)、エディター連携用のACPアダプター、バッチランナー、APIサーバーがあります。3 いずれも最終的にはrun_agent.pyのAIAgent.run_conversation()を呼び出し、次の処理を実行します。

  1. agent/prompt_builder.pyを介して、SOUL.md、MEMORY.md、USER.md、skill、コンテキストファイル、ツールの使用指針からシステムプロンプトを構築します(2026年9月の分割で、新しいagent/パッケージに移動しました)3
  2. runtime_provider.pyで実行時のプロバイダーを決定します。この段階で、認証、ベースURL、APIモードが選ばれます3
  3. chat_completions、codex_responses、anthropic_messagesの3つのAPIモードのいずれかでプロバイダーを呼び出します3
  4. 返されたツール呼び出しを、model_tools.pyと中央ツールレジストリ(tools/registry.py)を通じて振り分けます3
  5. モデルが最終応答を生成するまでループを繰り返し、その後FTS5を備えたSQLiteにセッションを永続化します3

このループを理解することは重要です。パーソナリティ、メモリ、skill、圧縮、フォールバックといったすべての機能が、これらの段階のいずれかに結びついているためです。設定キーを見て役割がわからないときは、たいてい「上のループの段階1、2、3、4のいずれかを調整するもの」と考えれば理解できます。

プラットフォームに依存しないコア。 1つのAIAgentクラスが、CLI、gateway、ACP、バッチ、APIサーバーを支えています。プラットフォームごとの差異は、エージェント自体ではなくエントリーポイントで扱います。3 ターミナルでもTelegramでも同じスラッシュコマンドが使えるのは、このためです。コマンドはhermes_cli/commands.pyの共有COMMAND_REGISTRYから振り分けられます。6

ディレクトリ構造がシステムそのものです。 Hermesはすべてを~/.hermes/配下に保存します(デフォルト以外のprofileでは$HERMES_HOME)。4

~/.hermes/
├── config.yaml        # Settings (model, terminal, TTS, compression, etc.)
├── .env               # API keys and secrets
├── auth.json          # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md            # Primary agent identity (slot #1 in system prompt)
├── memories/          # Persistent memory (MEMORY.md, USER.md)
├── skills/            # Bundled + agent-created + hub-installed skills
├── cron/              # Scheduled jobs
├── sessions/          # Gateway session state
└── logs/              # agent.log, gateway.log, errors.log (secrets auto-redacted)

上記の各ファイルには固有の役割があり、重複はありません。「HermesはXをどこに保存するのか」を知りたいときは、このいずれかが答えになります。


v0.22.6の新機能(v0.23.0直前の4回目の累積リリース)

v0.22.6(タグv0.22.6、コミットf0d94882、2026年11月2日、17:18 UTC公開)は、v0.22.2以降では4つ目となるリリースノートが簡略なパッチで、先行する3つと同じ説明を掲げています。「この期間の変更を整理した完全なノートはv0.23.0で提供します」。このリリースは「v0.22.5以降にマージされた約776件のPRをまとめたもの」で、マージコミットを除く3,448件のコミットで4,316ファイルが変更され(+248,579 / -94,077)、385件のissueがクローズされました。v0.22.5と比べると、v0.22.6のツリーでは1,504個のblobが追加され、237個が削除され、2,646個が変更されています。リリースで挙げられている内容と、タグから確認できる内容は次のとおりです。6667

  • WebappとDesktop。 hermes webappは、Hermes Desktopのワークスペースをブラウザーで開きます。config.yamlでwebapp.enabledがtrueのときにgatewayがこれを配信し、このコマンドは必要に応じてバンドルをビルドし、gatewayを起動して、1回限りのサインインリンクを開きます(--no-openはリンクを表示するだけ、--statusはgatewayが配信中かどうかを示し、--build-onlyはビルド後に停止します)。DesktopにはWeb Accessペインが加わり、自分のネットワーク上または独自のURLで、Nousのサインインを経てWebappを開けます。Desktopのプラグインはブラウザーのタブで読み込まれ、グループチャットは名前の変更と解散ができ、@メンションと貼り付けた添付ファイルを受け付けます。すべてのprofileがサイドバーのセクションとして表示され、cronエディターにはStopボタンが付きました。
  • セッション、skill、cron、コンパクション。 /model resetは、チャットの/modelによる上書きを解除し、履歴を失わずに、所属するprofileに設定されたモデルへ戻します(gatewayとDesktopのチャットコマンドです)。hermes curator lock <skill>は、エージェントがどの書き込み経路からも変更できないskillを宣言し、unlockで解除、hermes curator statusでロック中の一覧を表示できます。DesktopのCapabilitiesペインにも同じスイッチがあります。compression.prepare_ahead: true(デフォルトはfalse)は、圧縮の実行前にバックグラウンド処理で要約を準備します。hermes cron cancelは進行中の実行を停止します。各cronジョブはcatch_upを持てます。trueでは、マシンの停止中に逃したぶんをまとめて1回だけ補完実行し、falseでは次の実行枠まで飛ばします。キーがない場合、繰り返しジョブはcron.catch_up_missed(デフォルトはtrue)に従い、単発ジョブは120秒の猶予ルールを維持します。飛ばされた実行枠は、実行台帳に「missed xN」の1行として記録されます。/delegationでの選択はprofileのconfig.yamlにdelegation.backendとして保存され、次のセッションはその設定で開始します。
  • 移行、保管庫、プラグイン、プラットフォーム。 hermes migrate <agent>は、agent-importersプラグインが未導入ならインストールしたうえでhermes import-agent <agent>を実行します。このインポーターはGrok Bot(インポーターが表示するプロンプトからボット自身が書き出すセルフエクスポート)とOpenBotデスクトップ(そのopenbot.db)にも対応し、hermes setupはいずれかを検出するとインポートを提案します。保管庫のキーはOSのキーチェーンに保存できるようになりました。vault.key_storage: keychain(デフォルトはfile)で指定し、hermes vault key migrate --to keychain(または--to file)で移動します。keychain追加機能に含まれるkeyringパッケージを通じて、macOS Keychain、Windows Credential Manager、KWalletを使います。カタログエントリのrequires_hermesは、読み込み時だけでなく、プラグインのインストール時と更新時にも適用されます。ElevenLabs版のtext_to_speechは、呼び出しごとのvoice_idと、公開Voice Libraryまたは自分のアカウントの音声を対象にしたfind_voices検索を受け付けます。pre_llm_callプラグインフックは、{"action": "block", "message": "..."}を返して推論リクエストの前にターンを終了させたり、コンテキストを注入したりできます。Telegramのビデオノートはビデオメッセージとして届き、Slackの絵文字リアクションはスレッドのコンテキストとして引き継がれ、パッケージマネージャーは中断されたダウンロードを再開します(リリースノートの記載で、タグ内では特定できていません)。
  • GitHub Copilotがコアから分離されました(この期間内の10月25日)。 コミット1da2eb42「refactor!: GitHub Copilotをコアから削除(現在はgithub-copilot labsプラグイン)」は、plugins/model-providers/copilot/とcopilot-acp/を削除します。両モードは、NousResearch/hermes-labs-pluginsのコミュニティ区分プラグインgithub-copilotとして1つにまとめて提供されます(タグ時点でカタログに登録済み)。名前、設定キー、環境変数は変わらないため、移行は「プラグインをインストールする」だけです。hermes updateは、copilotまたはcopilot-acp経由で接続していたすべてのprofileにこのプラグインをインストールし(コア分離の移行テーブル)、エージェントとgatewayの起動時にはアクティブなホームに対してプロセスごとに1回再試行し、「unknown provider」のメッセージはいずれもhermes plugins install github-copilotを案内します。静的な選択リストからはcopilotとcopilot-acpの行がなくなり、agent/copilot_acp_client.pyは、カタログプラグインがサブクラス化する非推奨のエイリアスとしてのみ残ります。リリースノートにはこの変更への言及はありません。詳細はGitHub Copilot:2つのモードで説明しています。
  • タグv0.22.6時点。 プラグインカタログは763件から911件に増えています(148件を追加し、削除はありません。github-copilot、codex-theme、kubernetes、hermes-lang-cs、hermes-lang-he、hermes-model-switcher、hermes-profile-switcher、ElevenLabsの音楽と効果音のツールなどが含まれます)。plugins/platforms/は27ディレクトリのままで、plugins/model-providers/は41から39に減りました(copilot、copilot-acp)。新規追加は、plugins/config_backends/remote/(60ファイル)とhermes_cli/config_backend.pyです。後者はConfigBackendという接合層で、profileのconfig.yamlに対するすべての読み書きがここを通るようになりました。remoteバックエンドは各profileの設定を設定プレーンから配信し(起動時に取得して失敗時は安全側に倒し、ETagのポーラーで更新し、compare-and-swapで書き戻します)、HERMES_CONFIG_BACKEND=remoteでのみ選択され、一般的なプラグインとして読み込まれることはありません。変更がないのは、同梱のメモリプロバイダーであるByteRoverとRetainDB、ロケールカタログ、22行のplugin_compat.pyスタブ、sessions.auto_prune: falseです。

更新方法:CLIではhermes updateまたはインストーラーの1行コマンドを使います。StoreアプリはStore経由で更新されます。.exeまたは.dmgからインストールしたデスクトップアプリは、今回のリリースでは変更されず、次のバンドル版リリースで更新されます。DockerとHermes Cloudではnousresearch/hermes-agent:stable(または:latest)を取得します。66

v0.22.3〜v0.22.5の新機能(v0.23.0直前の累積リリース)

v0.22.2の後、2日間でリリースノートが簡略なパッチが3つ公開されました。3つとも同じ説明を掲げています。この期間の変更を整理したノートはv0.23.0に付属し、「v0.22.0以降のすべてを文書化する」とのことです。v0.22.3(タグv0.22.3、2026年10月21日、12:21 UTC公開)は「v0.22.2以降にマージされた約620件のPRをまとめたもの」です。マージコミットを除く2,911件のコミットで4,206ファイルが変更され、326件のissueがクローズされました。v0.22.4(10月21日、18:49 UTC公開)は、14件の修正コミットで構成されています。v0.22.5(タグv0.22.5、日付は10月22日、公開は10月23日05:28 UTC)は、v0.22.4以降の約81件のPRをまとめたもので、マージコミットを除く231件のコミットが804ファイルに及びます。v0.22.2と比べると、v0.22.5のツリーでは2,303個のblobが追加され、109個が削除され、2,298個が変更されています。このため、2つの累積リリースを合わせた変更規模は、v0.21.7からv0.22.0への変更を上回ります。各リリースで挙げられている内容と、タグから確認できる内容は次のとおりです。6465

  • v0.22.3:「ここでは意図的に文書化していません」。 MCPの進捗通知をツールの進捗としてリアルタイムに配信します。従来のCLIレイアウトを刷新しました(グリフを使った会話履歴、入力欄の下のステータス行、2行のヘッダー)。プラグインが宣言し、Hermesがサインインと更新を処理するOAuthクライアントに対応します。hermes plugins updateが利用可能なすべてのプラグイン更新を提示し、Desktopではgit経由でインストールしたプラグインに更新ボタンが追加されました。Desktopから実行の方向づけやキュー内のプロンプトの編集ができ、サブエージェントのモデルとプロバイダーを案内に沿って選択できます。CLIとTUIに/loopの残り時間をリアルタイムで示す行を追加しました。TelegramのDMトピック転送はオプトインで利用できます。post_compactionプラグインフック、機能カタログを追加し、リリース公開時にはMicrosoft Storeビルドも自動公開されます。セッションの自動削除は再びオプトインになり、ディスク容量が少なくなると1度だけ確認が表示されます。ローカルランタイムではNemotron 3.5 Boltと1スロットのDFlashドラフトに対応し、プラグインカタログにも数十件が追加されました。
  • v0.22.4:修正内容。 Desktopの入力欄の上に提案チップが表示されなくなりました(「明確な理由もなく表示され、主にMCPサーバーの設定を促していました」)。何もインストールしないプラグインでは、依存関係への同意手順を省略します。WhatsAppはログアウト後にダッシュボードから再ペアリングできるようになりました。Desktopの承認モードチップは、アクティブなprofileのモードに従います。デスクトップのプラグインレビューでは、表層的なlint検査がプロトタイプへの書き込みを指摘しなくなりました。カタログには、bubblewrap(Linux向けのbwrapターミナルバックエンド、hermes config set terminal.backend bubblewrap)、singularity(Singularity/Apptainer)、mcp-serve、agent-importers、Hermes Labsのinboxとworkflow-recordが新たに追加されました。Telegram BusinessはHermes Labsのコミュニティ区分に移行します。
  • v0.22.5:「ここでは意図的に文書化していません」。 Nousのサインインが見直されました(すべて通常のデバイスログインに統一し、無料枠のゲストから自分のアカウントへ引き継ぎ、結果にはサインインしたユーザーを表示します。コネクターはゲストを開く代わりにサインインを案内します)。hermes updateは、受け入れられない安定版リリースを提示せず、更新を保留するようになりました。Windowsのhermes updateで、Pythonの固定先を変更した後も古いランチャーに留まる問題が解消されました。利用期間枠を持つプランへの対応として、プランのゲージ、上限カード、モデル切り替えによる復旧を追加しました。差し替え可能な委譲バックエンドに対応します(モデルマップまたはprofileでサブエージェントの委譲先を振り分け、セッションごとに切り替えられます)。プラグインのスラッシュコマンドから選択肢を提示できるようになりました。hermes import-agent、OpenClawからの移行、hermes mcp serve、Singularityバックエンドはコアからプラグインへ移行します(セットアップ時に別のエージェントを検出すると、インポーターを案内します)。Desktopではサイドバーへのドラッグで固定でき、区分バッジ付きのプラグインをワンクリックでインストールできます。Electron 44へのアップグレード、Pillow 13と複数の依存関係のセキュリティ更新が含まれます。チャットの作業フォルダーがなくなった場合は、明確なメッセージを表示します。hermes updateは、.gitの破損後に一時停止したgatewayを復旧できるようになりました。Claude DirectSDKの長い回答が停止検知タイマーで打ち切られなくなり、Desktopのグループチャットでは、どのボットが作業中か再び表示されます。実験的なWebhookモードのMCPイベントクライアントも追加されました。
  • タグv0.22.5時点。 プラグインカタログは614件から763件に増えています(mcp-serve、agent-importers、bubblewrap、singularity、inbox、workflow-record、advanced-delegation、deadboltなど150件を追加し、codex-account-switchを削除)。plugins/platforms/のディレクトリは21個から27個に増えました(bluebubbles、qqbot、signal、weixin、whatsapp_cloud、yuanbao)。変更がないのは、41個のモデルプロバイダープラグインディレクトリ、同梱のメモリプロバイダーであるByteRoverとRetainDB、コアの17個とTUIの16個のロケールカタログ、22行のplugin_compat.pyスタブです。静的な選択リストは39行あります。sessions.auto_pruneのデフォルトは再びfalseになりました(デフォルト設定ファイルによると、state.dbを保存するディスクの空き容量が少なくなると、各インターフェースで確認します)。リポジトリのルートからmcp_serve.pyがなくなり、hermes mcpは、HermesをMCPサーバーとして実行する機能がmcp-serveプラグインにあると案内します。hermes_cli/claw.pyとsubcommands/import_agent.pyは削除され、agent-importersプラグインに置き換わりました。agent/にはdelegation_backends.py、delegation_provider.py、delegation_registry.pyが加わり、ドキュメントページdeveloper-guide/delegation-provider-plugin.mdが新設されています。

更新方法:CLIではhermes updateまたはインストーラーの1行コマンドを使います。StoreアプリはStore経由で更新されます。.exeまたは.dmgからインストールしたデスクトップアプリは、今回のリリースでは変更されず、次のバンドル版リリースで更新されます。DockerとHermes Cloudではnousresearch/hermes-agent:stable(または:latest)を取得します。64

v0.22.2の新機能と変更点(修正版パッチ)

Hermes Agent v0.22.2(タグ v0.22.2、2026年10月15日、08:21 UTC公開)が現在のリリースです。リリースノートは、この版が必要になった理由から始まります。「v0.22.1は誤ったコミットからビルドされました。未リリースのgateway関連の変更が含まれ、Microsoft Storeアプリが『Connecting』のまま止まる場合がありました。0.22.2は、本来0.22.1としてリリースするはずだったものです。」リリースコミット「公開済みのv0.22.1を親として、release/0.22.1から0.22.2をリリース」では、誤ったタグの上に意図したリリースブランチをマージしています。そのため、v0.22.1との比較では1,135ファイルが削除され、さらに846ファイルが変更されていますが、v0.22.0との比較では50ファイルの追加、1ファイルの削除、205ファイルの変更です。つまり、v0.22.0に対する小さなパッチが、v0.22.1との比較では大きな差分に見える形です。既知の問題が1つ明記されています。0.22.1のgatewayで実行したセッションは、0.22.2では削除できません。6263

  • 再起動後にgatewayが再び起動するようになりました。 Linuxでは、再起動後に起動初期のPIDが無関係なプロセスに割り当てられることがあります。gatewayがこれを稼働中のgatewayと誤認すると、監視下のgateway(systemd、launchd、Docker)が起動を拒否していました。Hermesは起動時のブートを記録するようになり、判別できない場合は、稼働中のgatewayだけが保持するホストロックを確認します(PR #138594、#133744を修正)。
  • ノートパソコンでも、ローカルモデルの長時間のターンを継続できるようになりました。 ローカルリクエストは常にストリーミングを使い、ステータス行にプロンプトの読み込み状況を表示します。停止検知タイマーはマシンのスリープ時間を除外し、ローカルサーバーが復旧すれば再試行します。以前のように遮断機構がその後のメッセージをすべて失敗させることはなくなりました。また、サーバーが長い会話を読み込んでいる間に圧縮がタイムアウトすることもなくなりました。Windowsのユニファイドメモリ搭載マシンでは、空きメモリ量に合わせてモデル起動時の設定とプロンプトキャッシュのサイズを調整します(PR #138560)。ソースコードでは、local_prompt_progress.py、sleep_clock.py、conversation_compression_deadline.pyなど、agent/配下の6つの新規モジュールに実装されています。
  • v0.22.1で案内され、v0.22.2にも残っているもの。 プラグインカタログは614件のままで、厳選モデルを優先するモデル選択画面とNemotron 3.5 Super VLのIDも含まれています。件数にも変更はありません。モデルプロバイダーのプラグインディレクトリは41個、選択画面の静的な行は39行、同梱のメモリプロバイダーはByteRoverとRetainDB、ロケールカタログはコアが17個、TUIが16個で、plugin_compat.pyのスタブは22行です。
  • v0.22.2で再び取り除かれたもの。 v0.22.1の変更一覧の多くを占めていた「session authority」と「canonical admissions」の再設計は、このタグから取り除かれています。対象はgateway/配下の118ファイル、hermes_cli/の47モジュール(大半がgateway_*)、トップレベルの21個のhermes_state_*.pyモジュール、agent/managed_worker.pyとruntime_session_*モジュール、ACP gatewayサーバー、デスクトップ関連の132ファイル、そしてgatewayの466テストです。v0.22.1のタグコミットに含まれていた、コンパクション時のskillマーカーの修正と、ドキュメントの「コンパクションをまたぐ読み込み済みskill」セクションも取り除かれています。リリースノートによると、mainにのみ存在する変更はv0.23.0でリリースされる予定です。

ハイライトの下にある変更一覧は、v0.22.0以降の0.22系全体を対象としています(機能追加19件、改善7件、不具合修正58件、ドキュメント8件、テスト9件、インフラ31件、その他の変更35件)。そのため、v0.22.1のリリースノートにあったカタログへの追加やモデル選択画面の変更も再掲されています。更新にはhermes updateまたはインストーラーのワンライナーを使います。これにより、v0.22.1を導入した環境を本来のリリース系列に戻せます。Store版はStoreから更新し、DockerとHermes Cloudではnousresearch/hermes-agent:stable(または:latest)を取得します。6263

v0.22.1の新機能と変更点(10月14日のパッチ)

Hermes Agent v0.22.1(タグ v0.22.1、2026年10月14日、23:59 UTC公開。リリースタイトルのビルドラベルはrc.5-v0.22.1)は、10月15日にv0.22.2に置き換えられるまでの8時間、最新リリースでした。v0.22.2の説明によると、v0.22.1は「誤ったコミットからビルドされ」、「未リリースのgateway関連の変更が含まれていた」ため、Microsoft Storeアプリが「Connecting」のまま止まる場合がありました。以下は、このタグに含まれていた内容の記録として残しています。引き続き含まれる変更については、v0.22.2の新機能と変更点をご覧ください。62 このリリース自体の説明は、「Windows Store向けのいくつかの修正、プラグインの更新などを含むパッチリリースです」という1文だけです。ノートの残りはコミット件名から生成された一覧です(機能追加111件、改善21件、不具合修正315件、テスト121件、インフラ41件、ドキュメント28件、その他の変更22件)。件名から判断すると、大半はユーザー向けの変更というより、内部基盤の整備(「session authority」と「canonical admissions」の再設計)です。GitHubでv0.22.0からの差分を比較すると、コミッター日時が9月24日から10月14日までの2,216コミットが数えられ、このタグにはv0.22.0のリリース時点より後にマージされた変更も含まれています。タグの内容から確認できるのは、次の点です。6061

  • プラグインカタログが601件から614件に増加しました。 リリースノートに記載され、タグにも存在するのは、韓国語とブラジルポルトガル語のデスクトップ言語パック(hermes-lang-ko、hermes-lang-pt-br)、TeamoRouterのモデルプロバイダープラグイン、author-feed、wait-ledger、lightningaiとlightningai-rate-limit、Hermes AAC、openinvest、hermes-agent-mixer、そしてメモリカテゴリに移動したKumiho Memoryです。
  • モデル選択画面。 大半のプロバイダーでは、厳選されたモデルIDがmodels.devのフィードより先に、各プロバイダーの一覧の先頭に表示されるようになりました(最新情報を優先する一部のプロバイダーでは、フィードの順序を維持します)。これにより、フィードの更新が遅れていても、エージェント用途の新しい候補が埋もれずに済みます。リリースノートには、Nemotron Super 3.5の新しいデフォルトパラメーターとIDの名称変更も記録されています。このタグの静的カタログにはnvidia/nemotron-3.5-super-vl-120b-a12bが掲載されています。
  • コンパクション後も読み込み済みのskillを保持します。 タグコミットとその前後のコミットでは、skillの再読み込みマーカーが修正されています。これにより、小規模なskill、スラッシュコマンドで呼び出したskill、フォールバック処理で要約したskill、並列で読み込んだskillが、コンパクション後も保持されます。開発者ガイドにも「コンパクションをまたぐ読み込み済みskill」セクションが追加されています。これは未リリースの変更の一部でした。タグコミットの変更とこのドキュメントセクションは、v0.22.2には含まれていません。63
  • このタグで変更されていないもの: プロバイダーのプラグインディレクトリ41個、選択画面の静的な行39行、同梱のメモリプロバイダーであるByteRoverとRetainDB、コアのロケールカタログ17個とTUIのロケールカタログ16個、22行のplugin_compat.pyスタブです。リリース説明で挙げられているWindows Storeの修正は、Windowsデスクトップのチケット初期化処理の修正以外には一覧から特定できないため、リリース側の説明に基づいて記載しています。

この版を使い続けないでください。v0.22.1を導入したCLI環境は、hermes updateまたはインストーラーのワンライナーでv0.22.2に更新できます。Store版はStoreから更新し、DockerとHermes Cloudではnousresearch/hermes-agent:stableを取得します。6062

v0.22.0の新機能(敷居を越えるリリース)

Hermes Agent v0.22.0(タグ v0.22.0、2026年10月13日付、10月14日公開)は、10月14日の大半にわたって最新版であり、現在もv0.22系の機能リリースに位置づけられています。v0.21.xの一連のロールアップで先送りされてきた変更を整理した記録でもあり、「v0.21.1〜v0.21.7のパッチリリースをまとめ、すべて文書化する」ものです。その位置づけは「Pantheon(神々の集い)」を引き継いでいます。「Hermesは敷居の神でした。出入り口、渡る場所、境界石を司る神です。v0.21.0では神々が集まりました。v0.22.0では、その扉をくぐります」。リリースに記載された統計は、「v0.21.0以降: 約24,200コミット · 約6,080件のPRをマージ · 約15,600ファイルを変更 · 約2,045,000行を追加 · 約1,140,000行を削除 · 約7,180件のIssueをクローズ · 約2,520人の貢献者」です。リリース自身の集計ではv0.21.0のサイクルの約2.5倍にあたり、v0.21.7以降だけでもGitHubの比較では756コミットあります。文書化された内容の多くはv0.21.1〜v0.21.7の期間に出荷済みで、以下の各節でもタグ時点の詳細を扱っています。この節では、リリース自身の位置づけ、アップグレード時の注意点、v0.21.7以降の新機能を、タグ時点のソースで確認したうえで記録します。5859

7つの変更により、このガイドの旧版で案内していた手順がそのままでは通用しなくなります。 更新前にご確認ください。

  • 管理対象のランタイムはPython 3.14です。 管理対象のインストールでは、パッケージマネージャーがこれを導入します(pm/lock.jsonでcpython-3.14.7に固定されています)。ソースをチェックアウトして使う場合、pyproject.tomlは引き続き3.11〜3.14に対応しています。3.14ではKittenTTSを利用できません。
  • Windowsデスクトップ版はMSIXのみとなり、 Windows 11 22H2以降が必要です。NSISとMSIのインストーラーは廃止されました。macOSの標準ビルドはApple Silicon専用です。
  • デフォルトは1台につき1つのgatewayです。 競合がなければ、hermes updateがprofileごとのgatewayを、多重化されたデフォルトのgatewayに統合します。profileをご覧ください。
  • アイドル時間や日次タイマーによるチャットのリセットは廃止されました。 session_resetのidleモードとdailyモードは廃止されています(設定に残っている場合は警告がログに記録され、hermes doctorでもタイマーの廃止が報告されます)。新しく始めるには/newまたは/resetを使います。
  • 古いセッションは自動的に削除されます。 sessions.auto_pruneはデフォルトで有効です。終了済みで90日間利用されていないセッションは、起動時に削除されます。ピン留めしたセッションと開いているセッションは削除されません。sessions.auto_prune: falseを設定すれば、すべて保持できます。この変更はv0.22.3の期間に取り消されました。v0.22.5ではデフォルトが再びfalseとなり、state.dbを保存しているディスクの空き容量が少なくなると、各インターフェースで1度だけ確認が表示されます(v0.22.3〜v0.22.5の新機能をご覧ください)。65
  • メモリプロバイダーはカタログに移りました。 対象はHoncho、Supermemory、Hindsight、Mem0、OpenViking、Holographicです。Home Assistant、Spotify、Langfuseも同様で、既存ユーザーは更新時または初回起動時に移行します。ByteRoverとRetainDBは引き続き同梱されます。外部メモリプロバイダーをご覧ください。
  • プラグイン作者向け: プラグイン互換性インポート層が廃止されました(22行のhermes_cli/plugin_compat.pyスタブは残っています)。hermes sync(Skill Sync)と同梱のtirithスキャナーも削除されました(設定のマイグレーション49から50でsecurity.tirith_*キーが削除されます)。また、3つのツール名がtodoからtodo_list、cronjobからcronjob_manage、processからprocess_manageに変更されています。旧名も引き続き使用できます。

リリースは機能分野別に整理されています。この概要も同じ構成です。

  • 初回起動から、対話で設定できます。 Hermesを1度も実行したことのないコンピューターでデスクトップアプリを開くと、設定画面の代わりにセットアップ用のチャットが表示されます。カードが1枚ずつ表示され、名前、アクセントカラー、レイアウト、接続するアプリ、インストールするプラグインを尋ねられます。その後、ツアーと、最初に試すタスクが最大4つ提案されます。OSユーザーごとに1度、無料のnous/welcome試用モデルで動作するため、キーは不要です。セットアップをスキップで終了でき、設定 ▸ オンボーディングを再実行でやり直せます。CLI、TUI、gatewayにはアカウントや無料モデルは提供されません。HERMES_GUEST_ONBOARDINGは廃止され、旧セットアップprofileフローと/initiate-setupも削除されました。また、エージェントにset_themeが追加され、デスクトップのどのチャットでも「紫のダークモードにして」と依頼できます。
  • コネクター:普段のアプリでHermesが作業します。 エージェントはNousのツールgatewayを通じて、LinearやNotionなどのホスト型アプリを操作します。使いたいアプリを伝え、ブラウザーで1度サインインすれば、同じターン内でツールを利用できます。開始時にNousアカウントは不要です。初回利用時にコネクター専用の無料IDが作成され、hermes auth upgrade(または任意のチャットやメッセージングのDMで/login)を使えば、接続済みのアプリを保持したまま通常のアカウントにアップグレードできます。デスクトップの新しい「コネクター」ページには、ホスト型アプリとMCPサーバーがまとめて表示されます(従来のMCPタブを置き換えます)。同じセットアップカードはTUIとCLIにも表示され、同じアプリの複数の名前付きアカウント(workとhomeなど)は、/connectorsまたはhermes connectorsで管理できます。nous.guest: falseでゲストIDを無効にし、tools.connectors.enabled: falseでコネクターを無効にできます。
  • ローカルモデルをワンクリックで導入できます。 Hermesはハードウェアに合ったllama.cpp(CPU、CUDA、Metal、Vulkan、ROCm、ビルドb11370)をインストールして管理します。カタログ内の各モデルをGPUとRAMに照らして評価し、収まる範囲で最も品質の高いビルドを選びます。Windows、macOS、Linuxでは設定 ▸ プロバイダー ▸ ローカルモデルから、ターミナルではhermes model → ローカルモデルから始められます。ダウンロードは一時停止と再開ができ、サーバーはHermesに合わせて起動・停止します。エンジンの更新もワンクリックです。ローカルLLMサーバーをご覧ください。
  • 安定版リリース、署名付きパッケージ、統一されたパッケージマネージャー。 デフォルトで追従する、テスト済みのSemVerリリースについては、v0.21.7で説明しています。v0.21.6とv0.21.7が最初にこの検証を通過し、更新確認に伴うGitHub APIの呼び出しは1日1回に減りました。デスクトップアプリは現在、専用のPythonとNodeを含む、封印・署名されたパッケージです。Windows(x64とARM64)ではApp InstallerまたはMicrosoft Store経由で署名付きMSIXを配布し、macOSでは署名・公証済みのApple Siliconビルドを提供します。内部では、hermes pmがバージョン固定・ハッシュ検証済みのすべてのツールとPython環境を管理します(doctor、status、repair、gc)。依存関係の環境は世代ごとに管理され、使用前に検証されるため、更新が失敗したり強制終了されたりしても、インストールが中途半端な状態で残らなくなりました。古い世代はhermes pm gcで削除できます。オプションのSDKは、security.allow_lazy_installs: falseが設定されていない限り、初回利用時にインストールされます。
  • プラグインカタログ:レビュー済みの600プラグイン。 このサイクルで公開されたカタログは600項目に拡大しました(タグ時点でYAMLファイルが601個、v0.21.7では552個)。各プラグインはレビュー済みのコミットに固定され、ドキュメントサイトにはプラグイン別・作者別のページがあります。インストール時には既知の問題の警告が表示されます。また、掲載ルールにより、内部実装を書き換える11個のプラグインが掲載対象から外されました(インストール済みのものは引き続き動作します)。メモリプロバイダー、Home Assistant、Spotify、Langfuse、TouchDesignerは、現在は公式カタログプラグインです。
  • Claude 5.5とGPT-6のモデル群。 Claude Fable 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5、GPT-6 Astra、Sol、Lunaに加え、GPT-6.1 SolとGemini 4 Argonを、Nous Portal、OpenRouter、各モデルに対応するネイティブ経路で選択できます。Opus 5.5はネイティブのAnthropicとBedrockでも利用できます。過去の推論を読み取れるすべてのプロバイダーでは、再開、分岐、圧縮をまたいで、過去の推論がデフォルトで再送されます。プロバイダーが一時的に不調な場合、ターンを終了する代わりに、agent.auto_recovery_cycles(デフォルト5)が、待機と再試行のサイクルを表示しながら回数を制限します。また、agent.turn_liveness.timeout_s(デフォルト600)は、進展のないターンを中断します。プロンプトキャッシュには、任意で有効にできるprompt_caching.cache_ttl: autoが追加されました(対話では1時間、サブエージェントとcronでは5分)。
  • パスワードマネージャーを使ってWebサイトにサインインできます。 ブラウザーエージェントは、1Password、Bitwarden、またはHermes独自の暗号化保管庫にあるログイン情報を使ってサイトにログインします。モデルにパスワードが渡ることはありません。新しいログイン情報は、値を伏せた確認画面から保存でき、ワンタイムコードも会話に含めることなく入力されます。決済時にカード情報や住所を入力する際は、確認が必要です。保管庫とブラウザーでのサインインは、以下のv0.21.2の節で初めて登場します。ここではリリースによる全体的な説明をまとめています。
  • Bot Screen。 Linuxのgatewayで動くボットに専用のデスクトップを持たせ、Hermes Desktopでライブ配信できます。ログイン、2FAの入力、CAPTCHAに遭遇したら、画面の操作を引き継いでその手順を済ませ、ボットに制御を戻せます。Docker、SSH、Singularityのバックエンドでは、ボットの画面、コンピューター操作、ブラウザーがサンドボックス内で実行されます(新しいデフォルトイメージはnousresearch/hermes-sandbox:desktopです)。デフォルトでは無効で、ホスト側にパッケージが必要です。
  • すべてのprofileを1つのバックエンドと1つのgatewayで扱います。 profileごとにプロセスを起動する構成から、1台につき1つのメッセージングgatewayと1つのデスクトップバックエンドですべてのprofileを処理する構成になりました。profileを作成すると、再起動せずにそのボットが稼働します。各profileは独自の認証情報、許可リスト、cronジョブ、セッションを保持し、Webhookを使うプラットフォームでは/p/<profile>/で各profileを提供します。hermes gateway statusは起動ガードによる拒否理由を説明し、hermes gateway migrate --multiplexで手動移行できます。hermes -p <name> gateway stop|startで1つのprofileを停止・再開でき、gateway.standalone: trueで一時的に従来の構成を選べます。
  • サブエージェントの動きを見ながら指示できます。 実行中のサブエージェントは、CLI(F6)、TUI(Ctrl+T)、Desktopの入力欄の上に表示され続けます。各子エージェントのタスク、経過時間、リアルタイムの会話記録に加え、指示と停止のボタンを利用できます。/stopはバックグラウンドの子エージェントにも届き、途中までの成果を回収します。delegate_taskは、画像を扱える子エージェントにスクリーンショットやモックを渡せます。子エージェントには、専用のフォールバックチェーン(delegation.fallback_providers)と無活動時のタイムアウト(delegation.child_timeout_seconds)も設定できます。
  • 契約プランの状況がわかるモデル選択画面。 よく使うモデルにスターを付け、サブスクリプションの残量が少なくなっていること(「残り17% · 午後3:00にリセット」)やレート制限の解除時刻を選択画面で確認できます。hermes model、/model(/model X --reasoning high)、Desktopでは、モデルとあわせて推論の強度も選べます。
  • どこでも自分の言語でHermesを使えます。 CLI、gateway、TUI、Desktopに表示されるすべての文字列は、共通の翻訳カタログを通ります。同梱の16言語を完全にカバーしています(タグ時点ではコア用カタログが17個、TUI用が16個)。プラグインに言語を含めることもでき(provides_locales)、profileごとに小さなYAMLファイルで個々の文字列を上書きできます。
  • あらゆる面で軽量化しました。 リリースによると、動作を一切変えずにソースコードを106万行から69万8,000行へ(−34%)、gateway/run.pyを34,847行から5,512行へ削減しました。使用頻度の低い約19個のツール(コンピューター操作、セッション検索、画像生成、cron、DesktopのGUIツール)は、エージェントが検索したときにだけ読み込まれるようになりました。これにより、呼び出しのたびに送信されるデスクトップのツールスキーマはおよそ半分になります(defer: []で無効化できます)。固定プロンプトからも約2,100トークンが削減されました。
  • 日々の使いやすさも向上しました。 任意で有効にできるvimキー操作(display.vim_mode)、ステータスバーのgit_branchフィールド、Hermesが入力を待っているときのベルとデスクトップ通知(display.bell_on_prompt)、ターンを終了せず下書きを消去するCtrl+C、編集可能な/queueが追加されました。hermes --native(またはdisplay.tui_native)ではTUIのスクロールバックと検索をターミナルに任せられます。hermes usage --jsonでセッションを開始せずに利用枠を確認でき、hermes -z <prompt>は失敗時に0以外の終了コードを返します。hermes mcp login <server> --flow deviceはヘッドレス端末に対応します。cronジョブはメインモデルに追従し(pinnedで固定できます)、--pausedと--interpreterを利用できます。Desktopには開発者向けペインを隠すシンプルモードも加わりました。

この期間に取り消された変更(未出荷): リポジトリ内に組織向けのskillマーケットプレイスを設けるCollective Wisdom V1は、マージ後に削除されました(「このリリースにwisdomのコードはありません」)。Desktopのカード形式のskill・プラグインカタログブラウザーは3回取り消されました。このほか、回答されるまで待機する承認・確認プロンプト(approvals.timeoutは引き続き適用されます)、Bot Modeでのグループチャットの並列ラウンド、名前付きprofileをルートのauth.jsonから完全に分離する変更、hermes cron resnapと作成時のモデルスナップショット(cronがメインモデルに追従する方式に置き換え)、Classicのデフォルトスキンの配色、tirithのカタログプラグインも取り消されました。58

更新方法:デスクトップアプリは自動更新され、Storeからインストールした場合はStore経由で更新されます。CLIではhermes updateまたはインストーラーの1行コマンドを使います。DockerとHermes Cloudはnousresearch/hermes-agent:stable(または:latest)を取得します。これらのタグが更新されるのは、リリースが公開されたときだけです。58

v0.21.7の新機能(10月11日のロールアップ)

Hermes Agent v0.21.7(タグ v0.21.7、2026年10月11日付、10月12日公開)は、10月12日から10月14日までの最新リリースで、v0.21.x系列では5回目にして最後の小規模なロールアップでした。タグとDockerイメージのみを提供したv0.21.6とは異なり、今回はデスクトップアプリ(macOS Apple siliconとWindows)、Microsoft Store版とMSIXビルド、インストーラー、Docker、Hermes Cloudというすべての配布チャネルがそろっています。v0.21.6以降の変更は「マージを除く740件のコミット」、「4,156個の変更ファイル」、「204件のマージ済みPR」、「69件のクローズ済みissue」に及びます(GitHubの比較では、マージを含めて777件のコミットと集計されています)。整理されたリリースノートは、前述のv0.22.0で公開されました。リリースに記載された内容を、タグ時点のソースで確認すると次のとおりです。5657

  • ソースからのインストールは、タグ付きリリースに追従するようになりました。 公式リポジトリのチェックアウトで hermes update を実行すると、main 上の各コミットではなく、公開済みの最新 vX.Y.Z リリースの正確なコミットに移動します。すでに最新リリースより先に進んでいるインストールは、次のリリースまでその状態を維持します。また、リゾルバーが推測でチェックアウトを過去に戻すことはありません。履歴が浅い、GitHubに接続できないなどの理由で前後関係が不明な場合は、HEADを維持します。引き続きすべてのコミットに追従するには、hermes update --set-channel main を実行してください。--channel <name> は1回の実行に限って設定を上書きします(stable と canary は公開済みリリース、main はブランチの先頭を選択します)。選択内容は、config.yaml の update.installs にインストール単位で記録されます。キーにはインストールパスから生成したIDを使います(hermes update --install-id で表示できます)。これは、1つの ~/.hermes をホスト側のインストール、Dockerのgateway、デスクトップアプリで同時に共有できるためです。フォーク、ミラー、originがローカルパスのインストールは、引き続き main に追従します。Store版、MSIX版、バンドル済みデスクトップ版のインストールに変更はありません。
  • デスクトップアプリにも同じ切り替え機能が加わりました。 ソースからのインストールでは、設定 ▸ このアプリについて ▸ 更新に更新チャネルの行が追加され、「安定版リリース」または「すべてのコミット」を選べます。更新ダイアログにも、現在のチャネル名が表示されます。
  • 再開後も推論が保持されます。 hermes chat --resume の後やgatewayでの次のターンで、署名付きの思考ブロックが再送され、上流側で検証されます。Bedrock Converseの推論モデルも、再開したセッションを拒否しなくなりました。上流側が拒否した署名はフィンガープリントで識別し、再構築したリクエストから除外するため、セッションが中断されることはありません。
  • 一部のファイアウォール環境で更新に失敗する問題が解消されました。 main に追従するインストールでは、地域によってファイアウォールが403を返すリリース情報を取得しなくなりました。安定版の確認では、GitHubトークンが設定されていればそれを使用します(GITHUB_TOKEN、または gh auth login)。トークンが拒否された場合は匿名で再試行し、GitHubのレート制限は「リリースなし」ではなく、レート制限として報告します。
  • Holographicがコアのソースツリーから分離されました。 同梱されるメモリプロバイダーは、ByteRoverとRetainDBのみとなりました。Holographicはプラグインカタログからインストールします(コミュニティ区分、requires_hermes: ">=0.21.5")。ほかの6つと同様に、自動移行の対象です。外部メモリプロバイダーをご覧ください。
  • プラグインカタログの登録数が493件から552件に増えました。 リリースによると、memory-shield、command-ledger、Memoria、Model Router、wyoming-voice-bridge、codex-account-switch、redlineなどが含まれます。プロバイダープラグインは41ディレクトリ、静的な選択リストは39行のままです。
  • リリースノートには、次の変更も記載されています。 プラグインから組み込みのDesktopアクション(ctx.runAction、例:view.showBrowser)を実行したり、ペットの吹き出しで発話したり(ctx.pet.say)できます。Codexへのリクエストはコアが行うため、プラグインがトークンを保持することはありません。セッション中にインストールしたskillは、プロンプトを再構築せずにモデルへ渡されます。新規の有料購読者には、デフォルトの画像生成経路としてKrea 2 Medium Turboが使われ、マネージド版Kreaがリクエストを拒否した場合はFALにフォールバックします。デスクトップの更新が高速化されました。固定されたインストールでは、固定先のみをチェックアウトします。また、コンパクションのマークがRelayに送出されます(agent/relay_compaction.py が hermes.compaction レコードをNeMo Relayのマークとして出力します)。

更新方法:デスクトップアプリは自動で更新され、Store版はStore経由で更新されます。CLIでは hermes update または1行のインストーラーコマンドを使います。DockerとHermes Cloudでは nousresearch/hermes-agent:stable(または :latest)を取得します。56

v0.21.6の新機能(10月8日のロールアップ)

Hermes Agent v0.21.6(タグ v0.21.6、2026年10月8日)は、10月8日から10月11日までの最新リリースでした。v0.21.x系では4回目の小規模なロールアップで、プロジェクトの新しい安定版リリースパイプラインで作成された最初のリリースです。このパイプラインは「試行ごとに1つのref、テスト済みのDockerイメージ、公開時の記録用タグ」で構成されます。提供されるのはタグ、GitHubリリース、Dockerイメージのみです。デスクトップアプリ、Termuxパッケージ、Microsoft Storeビルドは、次の一括リリースまで現行バージョンのままとなります。v0.21.5以降の変更規模は過去最大で、「マージコミットを除く8,867件のコミット」「変更された8,342個のファイル」「マージされた2,106件のPR」「クローズされた3,027件のissue」に及びます(GitHubの比較では、マージを含めて9,180件のコミットと集計されています)。整理されたリリースノートは、今回もv0.22.0に持ち越されました。リリースには未解説の項目が列挙されており、以下の各項目はタグ時点のソースで確認しています。5455

  • 話している最中にリアルタイムで文字起こしできます。 stt.streaming: trueを設定すると、CLI、TUI、Desktopで発話途中のテキストが逐次表示されます。デフォルトでは無効で、STTプロバイダーのopenai、xai、elevenlabsに対応します(stt.streaming_modelには発話途中の差分出力に対応するモデルを1つ指定し、OpenAIではgpt-live-transcribeを使います)。ストリーミングに失敗した場合は、ファイル経由の処理に切り替わります。
  • 音声ターン専用のモデル設定が加わりました。 auxiliary.voice_chatは、音声によるターン(CLIの音声入力、DesktopやTUIでの音声会話、メッセージングの音声メモ)を、セッションのメインモデルより高速なモデルに振り分けます。reasoning_effort: noneがデフォルトです。振り分けはシステムプロンプトの構築後に適用され、メモリ同期とバックグラウンドレビューの前に解除されます。音声モデルの圧縮しきい値に収まらないターンは、メインモデルで処理されます。補助モデルをご覧ください。
  • サードパーティー製プラグインを別プロセスで実行できます。 plugins.isolation: host(デフォルトはin_process)を設定すると、汎用プラグインはprofileごとに1つのプラグインホストプロセスに読み込まれます。ユーザーコードを同一プロセス内にインポートするほかの経路(カテゴリープロバイダー、モデルプロバイダーのprofile、ダッシュボードプラグインのAPI)はすべて拒否されます。同梱プラグインは引き続き同一プロセス内で動作します。プラグインがハングしたりクラッシュしたりしても、停止するのはそのホストであり、gatewayには影響しません。プラグインシステムをご覧ください。
  • さらに4つのメモリプロバイダーがコアのソースツリーから分離されました。 Honcho、Mem0、OpenViking、Supermemoryは、Hindsightに続き、プラグインカタログからインストールする方式になりました(コミュニティ枠で、各ベンダーが保守します)。同梱されるのはByteRover、Holographic、RetainDBです。v0.21.5で導入された自動移行は、この8つすべてを対象としています。外部メモリプロバイダーをご覧ください。
  • プラグイン互換レイヤーが削除されました。 hermes_cli/plugin_compat.pyは何も処理しないスタブとなり、COMPAT_MANIFEST.mdと互換シムは削除されました。plugins.allow_deprecated_importsも存在しません。分割前のパスから引き続きインポートしているプラグインは、インポートに失敗します。プラグインシステムをご覧ください。
  • hermes statusは概要を優先して表示します。 デフォルトの出力はコンポーネントごとに1行です。--full(別名--all)ではすべてのセクションを表示し、--deepでは時間のかかるチェックを実行します。リリースノートには--shortフラグも記載されていますが、概要表示がデフォルトのため、タグ時点のパーサーにこのフラグはありません。
  • プラグインで追加できる、階層化された言語パックに対応しました。 display.languageには、同梱カタログ(タグ時点で17言語)、profileのオーバーレイディレクトリ、プラグインの言語パックが提供する任意のIDを指定できます。hermes config set display.language <id>は最初にプラグインを検出するため、インストール直後のパックも指定可能です。コアとTUIの文字列は別々のレイヤー(locales/<lang>.yamlとlocales/<lang>.tui.yaml)として提供されます。タグ時点のTUIパックは16言語です。ローカライズをご覧ください。
  • 3つのプロバイダープラグインが追加されました。 lmstudio、solstice、tencent-tokenhubの追加により、plugins/model-providers/のディレクトリ数は38から41に増えました。静的な選択リストは39行のままです。NousとOpenRouterの選択リストには、GPT-6.1 Sol(-proバリアントを含む)、Claude Sonnet 5.5、Claude Haiku 5.5が追加され、openai-apiとBedrockのリストにもGPT-6.1 Solが加わりました。ローカルモデルについては、hermes modelがOllama、LM Studio、Ollama Cloudのモデルを直接一覧表示します。また、リリースによると、同梱のローカルランタイムにLinux x64およびarm64向けのllama.cpp CUDAビルド(llamacpp-cuda)が追加されています。
  • 承認ルールに2つの検出機能が加わりました。 curlまたはwgetによるアップロード(-d、-F、-T)に、名前がシークレットを示す変数や認証情報ファイルが含まれている場合、または認証情報ファイルがパイプで渡される場合は、情報流出の可能性があるとして警告されます。コマンド内の不可視文字や双方向Unicode制御文字は、難読化の可能性があるとして警告されます。承認時に見える内容と実際に実行される内容が異なるおそれがあるためです。
  • 保存先に書き込めなくてもcronは動作を継続します。 ディスク容量不足や読み取り専用マウント(ENOSPC、EROFS、EACCES)が発生すると、cronストアを一度だけ縮退状態にし、60秒ごとの処理のたびに警告することはなくなりました。再確認は最大で1分に1回行われ、hermes cron statusとhermes doctorで状態を確認できます(このリリースではホームチャンネルへの警告も追加されています)。
  • Discordのセットアップ時にボットトークンを確認し、招待リンクを表示します。 リンクにはアダプターが必要とする権限ビットが含まれます。また、Message Content Intentがまだ無効な場合は、その旨を知らせます。これが有効でないと、Discordがボットの接続を拒否するためです。メッセージングgatewayをご覧ください。
  • その他: 開発環境スクリプト./activateのfish版にあたるactivate.fishと、リリースノートに記載された統一的なKanbanワークフロー定義が追加されました。また、リリースには記載されているものの、今回のデスクトップビルドには含まれない機能として、Desktopの選択リスト上部へのお気に入りモデルとピン留めモデルの表示、サブスクリプションの上限に達する前に使用状況を示すチップ、理由と解除時刻を示すプロバイダーのレート制限通知、レビューペインの差分範囲セレクター、ターンに連動するスリープ防止機能があります。

セキュリティ修正については、すべてリリースに貢献者が明記されています。Tenable Researchが報告したダッシュボード認証の4件の問題が修正されました。具体的には、偽装したX-Forwarded-Forヘッダーでパスワードログインのレート制限をリセットし、IPごとの上限を回避できた問題、未認証のログインリクエストで認証監査ログにサイズ制限のない値を書き込めた問題、公開の/auth/ルートに本文サイズの制限がなかった問題、ネイティブサインインでループバック以外のリダイレクト先にログインコードを送信でき、セッションの乗っ取りにつながった問題です。また、自動的なgit呼び出し(セッションのワークスペーススナップショット、サブエージェントのworktree、kanban、worktreeのクリーンアップ、hermes -w)では、最初のプロンプトより前に、信頼できないリポジトリ自身の設定で定義されたclean、smudge、processフィルタープログラムを実行できました。現在はフィルターを無効化できない場合、その操作を拒否します。さらに、メールのFromヘッダーにある引用符付きの表示名を使って、許可された送信者としてメールの許可リストを通過できた問題も修正されました。現在はヘッダーの折り返しを解除した後にparseaddrで解析します(GHSA-rxqh-5572-8m77)。ダッシュボード、gateway、メールのいずれかを運用している場合、このタグはセキュリティ上重要なアップグレードとして扱ってください。5455

更新方法:hermes updateまたはインストーラーの1行コマンドを実行します。DockerとHermes Cloudではnousresearch/hermes-agent:stable(または:latest)を取得します。54

v0.21.5の新機能(9月24日のロールアップ)

Hermes Agent v0.21.5(タグ v2026.9.24、2026年9月24日)は、9月24日から10月8日までの最新リリースでした。v0.21.x系では3回目の小規模なロールアップです。「このタグは、v0.21.4以降にマージされた約460件のPRを、下流の利用者向けに安定したタグ付きリリースとしてまとめたものです」。整理されたリリースノートは、今回もv0.22.0に持ち越されました。以下は、タグ時点のソースで確認した運用者向けの変更点です。5253

  • Hindsightメモリがコアのソースツリーから分離されました。 同梱のHindsightプロバイダーとpipの追加依存指定hermes-agent[hindsight]が削除されました。Hindsightは、Vectorizeが保守するプラグインとして、プラグインカタログからインストールする方式になっています。この変更はリリースノートに記載されていません。設定にmemory.provider: hindsightがある場合、hermes updateは、それを指定しているすべてのprofileのホームにカタログのプラグインをインストールします。それでも未インストールの場合は、エージェントの初回起動時にインストールされます。ただし、security.allow_lazy_installsがfalseの場合は自動インストールされないため、hermes plugins install hindsightを実行してください。設定、.envのキー、メモリデータは変更されません。外部メモリプロバイダーをご覧ください。
  • gateway.multiplex_profiles: falseが廃止されました。 gatewayはこの値をその場でtrueに書き換え、枠付きの通知を1度だけ表示します。専用のgatewayを維持する必要がある名前付きprofileでは、そのprofile自身のconfig.yamlにgateway.standalone: trueを設定します。稼働中のprofileを1つだけオフラインにする場合、hermes -p <name> gateway stopでホストを停止せずに、そのprofileだけを休止できるようになりました。メッセージングgatewayをご覧ください。
  • NousとOpenRouterの選択リストに新しいモデルが追加されました。 GPT-6 SolとGPT-6 Luna(それぞれ-proバリアントを含む)、およびClaude Opus 5.5です。
  • このタグではプラグイン互換機能に変更はありませんでした。 plugins.allow_deprecated_imports: trueは引き続き機能していました。v0.21.6では、このレイヤーとキーが削除されます(v0.21.6の新機能をご覧ください)。

更新方法:hermes updateまたはインストーラーの1行コマンドを実行します。DockerとHermes Cloudのイメージはnousresearch/hermes-agent:v2026.9.24からビルドされます。52

v0.21.4の新機能(2回目のロールアップパッチ)

Hermes Agent v0.21.4(タグ v2026.9.21、2026年9月21日)は、v0.21.x系で2回目となる、リリースノートを意図的に簡潔にとどめたロールアップです。リリース自身は「パッチリリースです。このタグは、v0.21.3以降にマージされた約1,800件のPRを、下流の利用先(Dockerイメージ、Hermes Cloud、ホスト型デプロイ)向けの安定したタグ付きリリースにまとめたものです」と説明しています。v0.21.3以降の変更規模は、「マージ以外のコミット5,071件」「変更ファイル5,169個」「マージ済みPR 1,812件」「クローズ済みissue 2,116件」です。タグ間のコミット数では、v0.21.1の5,139件に次ぐプロジェクト史上2番目の規模で、マージ済みPR数では過去最多となります。整理された詳細な説明は今回も先送りされ、原文では「この期間の変更を整理した完全なリリースノートはv0.22.0で公開し、v0.21.0以降のすべてを記録します」「この期間の変更を省略することはありません」と明記されています。ただし、今回詳述しない項目の一覧は掲載されており、以下の各項目はそのタグのソースで確認済みです。このガイドの既存セクションに変更が関わる場合は、該当箇所へのリンクを添えています。5051

  • ホストごとにgatewayを1つに統一し、Desktopは再起動せず接続します。 ホストのOSユーザーごとに hermes serve と hermes gateway run をそれぞれ1つだけ実行し、各プロセスで全profileを多重化する方針です。これを新しいホスト全体のシングルトン層で強制します。先に起動したプロセスが終了までホストロックを保持し、さらに (pid, createTime) を記録したランデブーレコードを用意することで、2回目の起動時にロック所有者が同じ稼働中のプロセスであることを確認し、別のポートをバインドする代わりに既存プロセスへ接続できます。古いレコードかどうかは推測せず、必ず確認します。Desktopアプリ側も同じ考え方を採用し、2つ目のバックエンドを起動せず、ホスト上で稼働中のバックエンドに接続します。仕組みはメッセージングgatewayで説明しています。51
  • コネクターの操作をバックエンドに集約し、設定カードも統一します。 manage_connections ツールの呼び出しにより、バックエンド上の純粋なデータで構成された接続ステートマシンが動作します。Desktop、TUI、CLIはいずれも、これを同じ設定カードとして表示します。不足している認証情報ごとに入力欄が設けられ、必須項目すべてにテキストを入力するまで、カードの操作は実行できません。Nousの無料枠のサブセクションをご覧ください。51
  • --format stream-json:機械可読形式での単発実行。 hermes chat -q ... --format stream-json は、CIランナーやオーケストレーター向けに、標準出力の各行へJSONオブジェクトを1つずつ出力します。最初に system/init イベント、続いて text の差分、tool_use、tool_result イベントを出力し、最後に終了コード、最終テキスト、トークン統計を含む result エンベロープを1つ出力します。診断情報とセッションIDは引き続き標準エラー出力に送られ、ツール出力はイベントごとに5,000文字までに制限されます。このフラグは --quiet を暗黙に有効化し、-q または --query-file を必須とします(どちらもなければ終了コード2)。また、--tui とは併用できません。hermes chat のオプション表にこのフラグを掲載しています。51
  • skills.auto_load でskillを全セッションに固定できます。 config.yaml の skills.auto_load に列挙した名前のskillは、CLI、TUI、gateway、cron、APIのどれでも、新しいセッションごとに全文が読み込まれます。対象の解決は、プロンプトを最初に構築するときに1回だけ行われます。skillシステムに、固定するskillについてのサブセクションを追加しています。51
  • 未承認のDMに decline オプションを追加。 unauthorized_dm_behavior に、pair と ignore に続く3つ目の値が加わりました。decline は丁寧な拒否メッセージを1回送信し、その後24時間はその送信者に応答しません。ユーザー認可とペアリングをご覧ください。51
  • mcp.discovery_concurrency でMCPの検出時の同時接続数を制限できます。 デフォルトは4で、0 は無制限を意味します。設定済みのサーバーにはすべて接続しますが、接続が一斉に集中しなくなります。MCP連携をご覧ください。51
  • session_search に期間指定と検索漏れを補う再試行を追加。 ツールの検出時に提示される定義で、after/before による期間指定(ISO形式または 7d のような相対期間)を受け付けます。また、複数語のクエリで結果が0件だった場合は、FTS5の暗黙的な全語AND検索から、いずれかの語に一致する検索へ切り替えて再試行します。セッション検索をご覧ください。51
  • hermes sessions set-journal-mode delete|wal:オフラインのジャーナル変換コマンド。 state.db が意図しないSQLiteジャーナルモードになった場合に、自分で修正するためのコマンドです。従来は PRAGMA journal_mode=DELETE を手動で実行する必要がありました。まずgateway、ダッシュボード、すべてのCLIを停止してください。別のプロセスがデータベースを保持している間は実行を拒否し、保持中のプロセスが閉じるのを待ってから変更することもありません。変更後はSQLiteヘッダーのバイト列を検証します。Windowsには保持プロセスのスキャン機能がないため、すべてのHermesプロセスを手動で停止したうえで --force を渡すまで実行を拒否します。hermes doctor も、このコマンドを案内するようになりました。トップレベルコマンドの hermes sessions 行に掲載しています。51
  • Desktop:フォント設定、ワンクリックでのエンジン更新、プラグインのアンインストール。 設定にフォントファミリーの入力欄が追加され、profileごとに desktop.font_family へ保存されます。チャットとUI全体でテーマのサンセリフ書体を上書きし、候補リストではアクセシビリティに配慮した書体(OpenDyslexic、Atkinson Hyperlegible、Lexend)を先頭に表示します。空欄の場合はテーマの指定に従います。管理対象のローカルモデル実行環境では、更新が利用可能になると「エンジンを更新」ボタンが表示されます。更新に失敗してもその状態が表示されたままになるため、その場で再試行できます。また、プラグインハブでは確認ダイアログを経てプラグインをアンインストールできます。51
  • 動画カタログ:LTX 2.5とKling O3。 FAL動画プラグインに ltx-2.5(Lightricksのオープンソース音声・動画モデル:音声のネイティブ生成、画像から最大20秒・4Kの動画を生成、カメラモーションのプリセット、低価格枠。ただしfalは1440p/2160pでは10秒を超えるクリップを受け付けません)と、kling-o3(Kuaishouの最先端モデル群、プレミアム枠:複数ショットによるストーリーテリングをネイティブにサポート、音声は任意、3〜15秒)が追加されました。51
  • プラグインカタログをディレクトリとして同梱し、ウェブサイトでも公開。 リポジトリの plugin-catalog/ ディレクトリは、v2026.9.14 時点の9件から、このタグでは228件に増えました。各プラグインにレビュー済みのYAMLを1つずつ用意し、特定のコミットSHAに固定しています。ドキュメントサイトでは、プラグイン別と作者別のページを生成し、それぞれ固定したコミットのプラグインREADMEを表示するようになりました。リリースで名前が挙げられた10個のコミュニティ製プラグインは、このタグのカタログにすべて含まれています。詳細はプラグインシステムで説明しています。51
  • さらに多数の修正が、profile間・多重化時の分離、cron、カンバン、Desktop、state.db に加えられています。リリースではカテゴリ名のみが挙げられており、これらの修正を整理した記録はv0.22.0で公開される予定です。50

この期間にも、plugin-compatのrevertはまだ取り込まれていません。 v2026.9.21 には COMPAT_MANIFEST.md、compat_manifest.json、互換性shimがすべて残っています。この期間に hermes_cli/plugin_compat.py へ加えられた変更は、プロセス全体で共有するスキャンキャッシュと、Windows上での検出パスのPOSIX形式化(#112576)だけです。多重化されたgatewayは、提供するprofileごとにプラグインを1回検出しますが、毎回すべてのプラグインのソースを再解析すると、起動時にprofileあたり約0.4秒の負荷が発生していました。日付による制限と、リテラルの真偽値を使う回避策は変わっていないため、plugins.allow_deprecated_imports: true を設定すれば、影響を受けるプラグインを引き続き読み込めます。プラグインシステムの互換性に関する囲み記事に現状を記載しています。42

更新方法は変わりません。git経由でインストールした場合は hermes update、新規インストールにはシェルインストーラーを使います。DockerとHermes Cloudのイメージは、このタグ(nousresearch/hermes-agent:v2026.9.21)からビルドされます。50

v0.21.3の新機能(9月14日のパッチ)

Hermes Agent v0.21.3(タグ v2026.9.14、2026年9月14日)は、さらに3日分の main の変更を、2項目のリリースノートにまとめたものです。Cloudエージェントが最新のリリースタグへ自動更新されるため、リモートgatewayへのサインイン修正を届ける目的でリリースされました。(1)リモートダッシュボードのセッションが、更新リクエストの集中によって失効しなくなりました。gateway上の2つの更新経路(Cookieによる認証経路と、DesktopのネイティブBearer認証ルート)はどちらも、同じローテーション式リフレッシュトークンを持つ同時リクエストを1回の処理にまとめます。これにより、Desktopのスリープ復帰時にリクエストが集中しても、すでにローテーション済みのトークンを再送してPortalの再利用検出に引っかかり、セッション全体が失効することはなくなります。また、更新処理はイベントループの外で実行されるため、IDプロバイダーの応答が遅くても /api/status が停止しなくなりました。(2)長時間稼働するプロセスが、state.db の書き込み用ハンドルを重複して作成しなくなりました。gateway、ダッシュボード/Desktopバックエンド、ACP、CLIの読み取り処理は読み取り専用で接続し、同一プロセス内の書き込み処理はレジストリのハンドルを共有します。この期間の変更規模は、「マージ以外のコミット1,036件」「変更ファイル2,642個」「マージ済みPR 338件」です。それ以外の説明は意図的に先送りされています。リリースでは今回詳述しない項目として、すべてのモデル選択画面での推論量の選択、OpenRouter OAuth PKCE、HEIF/HEIC/AVIFのデコード、FALカタログへの多数の追加、Slackに貼り付けた表とAgent Sessions API、複数VMにまたがるファイルシステム上での state.db のWAL拒否などを挙げています。そのうえで、整理された記録について原文で「この期間の変更を整理した完全なリリースノートはv0.22.0で公開し、v0.21.0以降のすべてを記録します」「この期間の変更を省略することはありません」と約束しています。49

そして、plugin-compatの期限は予定どおり到来しました。 v0.21.1で告知された2026年9月14日の削除は、コードのrevertではなく、配布コード内の日付による制限として有効になりました。タグ v2026.9.14 の hermes_cli/plugin_compat.py には COMPAT_REMOVAL_DATE = 2026-09-14 が設定されており、その日以降(またはマニフェストファイルがなくなった時点で)removal_in_effect() がtrueを返します。そのため、影響を受ける外部プラグインは、読み込み時に赤い通知とともに無効化されます。一方、古いインポートパスを実際に削除するrevertは、まだ行われていません。COMPAT_MANIFEST.md、compat_manifest.json、互換性shimは、このタグにも、v2026.9.21 と9月22日時点の main にも、すべて残っています。だからこそ、plugins.allow_deprecated_imports: true が回避策として引き続き機能します。ローダーの続行を許可すれば、古いパスはまだ解決できるためです。注意点は2つあります。このキーには、YAMLのリテラルの真偽値を指定する必要があります。ソースの「リテラルの真偽値のみ」というコメントどおり、コードが受け付けるのは真偽値の True だけで、"true" や "false" のような引用符付き文字列は未設定として扱われます。また、revertが取り込まれるとパス自体が消えるため、この回避策もその時点で使えなくなります。プラグインシステムの互換性に関する囲み記事に現状を記載しています。4249

v0.21.2の新機能(state.dbのパッチリリース)

Hermes Agent v0.21.2(タグv2026.9.11、2026年9月11日)の主な目的は、v0.21.0で生じた不具合の修正です。リリースノートにも明記されています。「v0.21.0ではセッションストアの接続処理を大幅に書き直しましたが、一部の環境ではstate.dbが不安定になりました。別の書き込み処理が互いのロックを解除する、正常なデータベースが破損していると報告される、1行の不正なデータでsessions listが動かなくなる、といった問題です。今回のリリースではこの種の問題を解消し、v0.21.1以降の4日間にmainへ入ったその他の変更もまとめています」。意図的に簡潔にまとめられたv0.21.1のノートとは異なり、今回は主な変更点も記載されています。この期間の統計は「マージ以外のコミット947件」「変更ファイル1,869件」「マージ済みPR 312件」「貢献者140人」です。v0.21.x全体の変更を整理した記録は、引き続きv0.22.0でまとめられる予定です。48

  • state.dbの信頼性向上:6件のPRで44件の問題を解決。 リリースノートは運用者向けの助言から始まります。まず取り組むべきことも同じです。0.21.0または0.21.1でstate.dbが壊れた場合は、hermes doctorを実行してください。すべてを「FTS書き込み破損」と扱う代わりに、構造の破損と全文検索インデックスの破損を区別して表示するようになりました。再構築だけでは足りない場合は、hermes sessions recover --inspect-onlyを案内します(オフラインかつ非破壊で、対象profileを固定し、出力データベースを作成せずに正規テーブルが読み取り可能かを報告します)。根本原因への対処として、ストアに対する追加の書き込み元をすべて排除しています。profileごとのgatewayは5秒ごとにホスト対象ルームの状態をルートのstate.dbへ書き込んでいましたが、この連携処理を専用のshared-state.dbへ移したため、マスターのセッションストアを書き込み可能な状態で開くことがなくなりました。ダッシュボードはまず読み取り専用で開きます。cronのライフサイクルガードは、稼働中のデータベースに直接open()を実行する代わりに、追跡対象の接続レジストリを経由します(直接開くとgatewayのPOSIXロックが解除されます。SQLiteを破損させる典型的なパターンです)。また、doctor --fixは安全性を確認できないcheckpointを拒否します。書き込み元以外にも変更があります。FTSインデックスが破損した場合は、ターン全体を停止するのではなく、検索機能を制限して後でインデックスを再構築します。1行の破損でsessions list、エクスポート、インサイトが動かなくなることもなくなりました(不正な行は?と表示され、対象セッションを示す警告が出ます)。セッションが別のprofileのデータベースに接続したり、そこから読み取ったりすることもありません。読み取り専用で開く際に書き込みロックを取得しなくなったため、稼働中のgatewayがある環境での単発のhermes実行は、4~20秒待った末に失敗する状態から、0.01秒で完了するようになりました。48
  • 複数profile間の分離を強化。 このガイドではv0.19.0以降、profileルーティングにより各profileの「設定、skill、メモリ、シークレットが完全に分離される」というプロジェクトの説明を繰り返し紹介してきました。v0.21.2では、その約束に残っていた穴がふさがれました。追加profileのボットがデフォルトprofileの許可リストを引き継ぐ、アダプターが認証情報をデフォルトprofileのホストへ送信しうる、stdio MCPサーバーにデフォルトprofileの保管庫のシークレットが渡される、MEDIA:による配信で別のprofileの.env/auth.json/state.dbが添付されうる、webhookやFeishuのコールバックがルーティング先のprofileから外れる、追加profileがプロセス単位のキャッシュから別のprofileのNous bearerトークンを取得しうる、といった問題です(#107609-#107630)。1つの多重化されたgatewayで複数のprofileを運用しているなら、分離の約束が実際に満たされるのはこのリリースからです。48
  • パスワードをエージェントに見せない認証情報保管庫。 1Password、Bitwarden、またはローカルのHermes保管庫を使い、エージェントがシークレットを一度も見ることなく、ブラウザーでのサインイン、支払い、住所入力を行えるようになりました。2要素認証コードは、保存済みの認証キーから生成するか(TOTP:base32シードまたはotpauth://totp URI。カウンター方式のHOTPは拒否されます)、UIで入力を求めます。どのバックエンドもエージェントに渡す形式は共通です。ログインのメタデータと、名前空間付きの不透明なハンドル(ローカルはvault_、ほかにop:、bw:)を渡し、パスワードを取得するのはフォームへの入力時だけです。外部マネージャーは、そのセッションでロックを解除するまでロック状態を維持します。マスターパスワードは「ツールの引数にもargvにも渡されず、永続保存もされません」。これは、プロバイダーのAPIキーを平文の.envから切り離したv0.19.0のSecretSourceの取り組みを基盤としています。今回の保管庫では、エージェントがブラウザーで使う認証情報にも同じ仕組みを適用しています。48
  • 選定済みプラグインをSHAで固定するカタログ。 hermes plugins browseは「選定済みプラグインカタログの全項目」を一覧表示し、hermes plugins searchはカタログを検索します。hermes plugins installでは、Git URLやowner/repoに加えてカタログ名も指定できます。さらに、hermes plugins packが「宣言的で共有可能なプラグインセット」を提供します。1つのhermes-pack.yamlでプラグイン群を正確なコミットSHAに固定し、pack installで通常のバージョン固定インストールを各プラグインに適用します。機能の利用許可は引き続きプラグインごとに行います。pack exportは現在のインストール内容をpackとして出力し、pack showではドライランを実行できます。新しいサブコマンドはプラグインシステムのコマンドブロックに掲載しています。48
  • Nousの無料枠と初回起動ガイド。 新規インストールでは、1つのコマンドでサインインすれば、無料の推論とコネクターをすぐに利用できます。チャット内から/loginを実行でき、コネクターツール(Gmail、Linear、Notionなど)はtool_searchで検索できます。デスクトップの初回起動ガイドはHERMES_GUEST_ONBOARDING=1で有効になります。有効にする値は文字どおりの1だけです。デスクトップ自体のテストでも、'true'、'0'、空の値ではいずれも無効のままであることを確認しています。また、起動時の判断結果は生成されるバックエンドの環境変数に明示的に設定されるため、継承された値が意図せず反映されることはありません。Nous Tool Gatewayをご覧ください。48
  • デスクトップでバックエンドが大量起動する問題を解消。 以前のBot Modeは、起動時とボット一覧の更新時に、profileごとにバックエンドを起動するか接続していました。また、Bots一覧にマウスポインターを重ねると行ごとにバックエンドが起動し、profileの切り替え時にはプライマリーバックエンドが重複して起動することもありました。この期間に、これらはすべて修正されています。48

更新方法に変更はありません。既存のインストールではhermes updateを実行し、新規の場合はシェルインストーラーを使います。48

v0.21.1の新機能(累積パッチ)

Hermes Agent v0.21.1(タグv2026.9.7、2026年9月7日)のリリースノートは、意図的に簡潔にまとめられています。「タグ付きデプロイと下流の利用者向けに、v0.21.0以降の現在のmainをまとめた」「パッチリリース」です。本文では、対象期間の統計として「4,364個の変更ファイルにわたる5,139件の非マージコミット(+601,014 / -768,419)」と「632件のマージ済みPR」を示したうえで、詳しい説明は先送りしています。「この期間の変更を整理した完全なリリースノートは、v0.22.0で公開します」。つまり、プロジェクト史上最大のタグ間変更が、最も短いリリースノートで公開されたことになります(これ以前の隣接タグ間では、v2026.7.20..v2026.7.30の非マージコミット2,790件を超える期間はありません)。v0.22.0で変更記録が整理されるまで、このタグでのHermesの運用に影響する変更を以下の6項目にまとめます。いずれもソースで確認済みです。41

  • コードベースが分割され、プラグイン互換性の猶予期間は9月14日に終了しました。 2026年9月の分割作業(PR #102117)により、リポジトリ内の大きなモジュールが役割別のファイルに分かれました。新しいagent/パッケージには会話ループの内部実装が収まっています(トップレベルのモジュール214個とサブパッケージ7個。prompt_builder.pyはagent/prompt_builder.pyに移り、AIAgentは引き続きrun_agent.pyにあります)。CLIのサブコマンドパーサーはhermes_cli/subcommands/パッケージ(61モジュール)に移動し、静的なCANONICAL_PROVIDERSリストはhermes_cli/models.pyからhermes_cli/models_catalog_static.pyに移りました(リスト自体は変更されておらず、静的な39エントリに、同梱された39個のプロバイダープラグインディレクトリから引き続き自動追加されます)。また、delegate_taskは約12個のtools/delegate_tool_*モジュールに分割されました。内部のインポートパスは安定したAPIではないため、リポジトリのルートに新設されたCOMPAT_MANIFEST.mdでは、移動先を遅延解決する「moved-lazy」方式で旧モジュールパスから再エクスポートする1,148個の公開名を記録しています。それぞれ解決時に、名前ごと、プロセスごとに1回だけHermesPluginCompatWarningを出します。この互換レイヤーは一時的なもので、タグの6日後にあたる2026年9月14日、予定どおり廃止措置が発効しました。コードの差し戻しではなく、出荷済みコードに組み込まれていた日付条件によるものです。この日以降、影響を受けるサードパーティー製プラグインは読み込まれません。CLIのバナー、hermes doctor、hermes updateには無効化されたプラグイン名を示す赤い通知が表示され、デスクトップには1回限りのモーダルが表示されます。hermes plugins listでは理由を確認できます。外部プラグインを利用している場合は確認してください。hermes plugins compat <path>は、該当するすべてのfile:lineを旧パス -> 新パスとともに出力し、1件でも残っていれば終了コード1を返します(機械可読の出力には--jsonを指定し、インストール済みプラグイン全体を調べるには引数なしで実行します)。作者の対応がまだ済んでいないプラグインには、config.yamlでplugins.allow_deprecated_imports: trueを設定する回避策があり、現在も機能します。旧インポートパスを実際に削除する差し戻しは9月22日時点でも取り込まれていないため(タグv2026.9.21とmainで確認済み)、ローダーの処理を許可すれば旧パスは引き続き解決されます。その後の詳細は上のv0.21.2の新機能に、現在の状態をまとめた囲みはプラグインシステムの節にあります。42
  • gatewayの会話は、タイマーでは一切切り替わらなくなりました。 セッションのライフサイクルに関するドキュメントでは、動作仕様が明記されています。「操作のない状態が続いても、実時間が経過しても、会話は切り替わりません。/newと/resetが明示的な区切りを作り、長い履歴は引き続きコンテキスト圧縮で管理します。旧来のタイマー設定は無視されます。既存のSessionResetPolicyデータ型は、実行時のポリシーではなく、動作に影響しない互換性用のデータです」。区切りはユーザーが明示的に作ります。hermes claw migrateでOpenClaw時代のセッションリセットタイマーを引き継いでいても、現在は動作に影響しないデータとなっています。メッセージングgatewayをご覧ください。43
  • MCP認可にデバイスコード方式が加わりました。 hermes mcp login <name>に--flow {browser,device}が追加されています。browserは既存のPKCEフロー、deviceはブラウザーのコールバックを使いにくいマシン向けのRFC 8628デバイスコードログインです。このフラグはサーバーのoauth.flow設定より優先されます。この期間には、MCP認証のほかの部分も強化されました。OAuthセッション全体でprofileの所有権が検証され、不正な形式のOAuthメタデータキャッシュはサーバーを動作不能にすることなく無視されます。また、デスクトップはクライアント側のローカルコールバックを通じてMCPのOAuthを中継します。関連する変更として、-t/--toolsetsで、設定済みのMCPサーバーのうち起動するものも絞り込めるようになりました。そのため、hermes -z -t <toolsets>による単発実行では、不要なサーバーのコールドスタートを省略できます。MCP連携のコマンドブロックには、loginとreauth [--all]も追加しました。どちらもこの期間より前から存在していましたが、ここでは未記載でした。44
  • 委任処理で、バックグラウンド作業の実態を正確に把握できるようになりました。 delegate_taskに関する信頼性の改善は6点あり、すべて当該タグの委任ツールのソースで確認しています。(1)バックグラウンドのバッチは、デフォルトでは1つの完了通知として返ります。delegation.independent_completionsを有効にすると、呼び出しが完了通知の単位に分かれます。同じgroup値を持つタスクはまとめて完了を報告し、グループに属さないタスクはそれぞれ終了時に個別に報告します。このデフォルトは意図的なものです。ソースには、タスクごとに完了通知が相次ぐと「それを想定していないオーケストレーターの処理が断片化した」と記されています。(2)子エージェントのバックグラウンドプロセスは、子エージェントがprocess_manage(action="handoff")で親に引き渡さない限り、終了処理時に強制終了されます。引き渡されずに残ったプロセスは結果のorphaned_processesに名前が記録され、出力が一度も読み取られずに終了した子プロセスは、出力末尾とともにunread_completionsとして報告されます。ソースのdocstringが示す設計方針では、子エージェントの「監視プロセスは動いています」という主張を信じるのではなく、親が「ランタイムからその事実を受け取る必要があります」。(3)delegation.fallback_providersが実際に使える設定項目になりました。nullでは、固定指定のない子エージェントが親のフォールバックチェーンを継承し、[]ではフォールバックを無効にします。プロバイダー、エンドポイント、モデルのいずれかを固定指定した子エージェントには、この設定で明示しない限りフォールバックが適用されません。(4)子エージェントのフォールバックチェーンは共通の正規化処理を通じて解決されるため、不正な形式のエントリは起動失敗を引き起こさずに除外されます。(5)処理単位の途中でクラッシュしても、完了した子エージェントの結果は失われなくなりました。複数の子エージェントを含む処理単位では、それぞれの完了結果がその処理単位自身の行に永続的に記録され、復旧後の結果にも部分的な成果として残ります。(6)サブエージェントが1時間のプロンプトキャッシュ枠を継承することはありません。委任された子エージェントは5分枠に変更されます。1時間枠の料金設定は、席を離れる人の利用を想定したものであり、短時間に並列実行される子エージェント向けではないためです。45
  • プロバイダーとモデル。 Nous PortalとOpenRouterのカタログに、OpenAIのGPT-6 AstraとAstra Proが追加され、速度枠のバリエーションとして-fast/-flex(「料金2倍、優先枠」/「料金0.5倍、flex枠」)も用意されています。ChatGPT/CodexのOAuth経由では、Astraの利用可否はアカウントによって制限されます(実際のアカウントを対象としたライブ検出でのみ、利用可能なモデルとして表示できます)。また、モデル選択画面には、任意で選べる-900kバリエーションが追加されました。これにより、公称272Kのコンテキストウィンドウが、ライブ検証済みの約900Kに拡大します。このサフィックスが通信時に送信されることはありません。このほか、anthropic/claude-fable-5.1、google/gemini-3.7-flashとgemini-3.8-flash、qwen/qwen3.8-max-0902とqwen3.8-flash、MetaのMuse Spark 1.3ファミリー(1Mコンテキスト、コントリビューター向けバリエーションを含みます)、さらにMetaの画像生成プロバイダープラグインmuse-imageが加わっています。Tavilyもウェブ検索・抽出のバックエンドとして追加されました(TAVILY_API_KEY。hermes toolsからTavilyを選択した場合は、キーなしでも動作します)。管理機能付きのllama.cppランタイムにより、ローカルモデルも標準的な選択肢になりました(公式バイナリ、監視下で動作する単一のllama-server、デスクトップからのワンクリックセットアップ)。リポジトリ外の外部プロセス型プロバイダーにも、専用の解決処理が用意されています。運用面では、モデル選択画面のリモートカタログが20分ごとに更新されるようになりました(model_catalog.ttl_minutes、デフォルトは20。旧来のttl_hoursキーは、ユーザーが明示的に設定していた場合に限り適用されます)。46
  • デスクトップ:ページに注釈を付け、セッションを操作できます。 アプリ内ブラウザーにコメントモードが追加されました。「注釈」をクリックしてから、表示中のページの任意の要素をクリックするか、ドラッグして範囲を囲み、メモを入力します。保存したコメントは番号付きのピンとして残り、それだけでターンが送信されることはありません。入力が終わったら、「N件のコメントを追加」でまとめて入力欄に渡します。各ピンには切り抜いたスクリーンショットが付き、要素へのコメントにはCSSセレクター、マークアップ、レイアウトに関わる計算済みスタイルも添付されます。そのため、エージェントは画像から推測するのではなく、ソース内の要素を特定できます(パスワード値、非表示の値、キーらしい属性は、マークアップがページ外に送られる前に伏せられます)。コメントが多い場合はページの領域ごとにまとめられるため、20件余りのコメントが少数の作業単位になります。通常、それぞれが別のファイルに関わるので、並列ワーカーに安全に分配できます。このほか、体系化されたセッション操作とセッション自動化の操作、ドラッグによるセッション作成、他のコーディングエージェントの会話記録を取り込むセッションインポート画面、display.resume_last_session(デフォルトはtrueで、コールドスタート時に前回のチャットまたはページを開きます)が追加されています。また、browser.use_real_profileがオフの状態でブラウザーペインを初めて開いたときに、その利用への同意を求めるプロンプトが表示されます。「機能」->「Skills」にはワンクリックでインストールできる任意のskillの組み込みカタログが加わり、デスクトップUIは新たにロシア語に対応しました(CLIの17言語のロケールカタログに変更はありません)。47

更新方法は変わりません。既存のインストールではhermes updateを使い、新規インストールではシェルインストーラーを使います。この期間の変更を整理した記録はv0.22.0に委ねられていますが、当該タグで変わる点は上記のとおりです。41

v0.21.0の新機能(The Pantheon Release)

Hermes Agent v0.21.0(タグv2026.8.31、2026年8月31日)は、現在の機能リリースです。v0.20.xの一連のロールアップで後回しにされてきた変更内容を、ここでまとめて整理しています。「このリリースは、v0.20.1〜v0.20.6のインフラパッチタグに含まれるすべての変更を統合しています。各期間の変更は、ここにすべて記録されています」。位置づけはHeraldの続編です。「v0.20.0でHermesは伝令役になりました。言葉を発し、ほかのエージェントへ伝える役目です。v0.21.0では、神々が集います」。統計欄には、次のように記されています。「v0.20.0以降:約5,800コミット · 約2,475件のPRをマージ · 約5,680ファイルを変更 · 約869,000行を追加 · 約135,000行を削除 · 約2,100件のissueをクローズ · 760人以上のコントリビューター」。35

リリース内容は機能分野ごとに整理されているため、この概要も同じ構成にしています。このガイドの既存セクションに変更がある機能には、本文中に参照リンクを添えています。

  • Bot Mode:エージェント同士が集う場を標準搭載。 Bot Modeは、v0.20.3の期間に同梱されたhermes-botsプラグインから、デスクトップアプリでデフォルトで有効な機能へと昇格しました。各エージェントのprofileには、名前、ランダム化と固定の操作ができる決定的に生成された顔のアバター、共有メンバー一覧の枠が割り当てられます。Discord風のグループチャットを作成して、複数のボットと同じ部屋で会話したり、入力欄から任意のボットを@メンションしたり、部屋に名前や画像を設定したりできます。関連機能には、送信元を明示したエージェント間メッセージカード、送信側への配信通知、復帰時の即時表示を可能にする描画優先のハイドレーション、Routinesペイン、アプリのデザインシステムに合わせた再構築が含まれます。リリース自身の言葉では、「以前の『マルチエージェント』は接続の仕組みを意味していましたが、今では同僚が集まるチャットアプリのようになりました」。35
  • hermes peer:エージェント間でボット同士のDMを送信。 どのHermesエージェントからでも、ハンドルを指定してほかのエージェントにメッセージを送れます。profileやgatewayをまたいで、CLIからでも会話の中からでも利用できます。調査用ボットに調査結果をコーディング用ボットへ渡すよう依頼し、その場で返答を読めるのです。「返信は各エージェントの正規のBot Chatに届くため、エージェント間の会話は送って終わりにはならず、永続化され、後から確認できます」。hermes peerコマンド(ピアの追加・一覧表示・削除、dm)は、トップレベルコマンドの表に記載しています。35
  • 記憶を持つcronジョブ。 スケジュールされたジョブも、実行のたびに前回のことを忘れなくなります。cronエージェントはほかのエージェントと同様に永続メモリを読み込み、更新します。continuity=trueは各実行の出力を次回に引き継ぐため、監視処理で報告済みの内容との重複を排除できます。すべてのジョブに永続的な作業用メモ帳が用意され、監視モードのジョブは変化がなければLLMを完全にスキップします。推論の強度はジョブごとに固定でき、cronの出力をボットの正規のBot Chatに届けて、そこで実際にボットから応答を得ることもできます。スケジュールタスク(cron)セクションでは、各機能のタグ時点での動作を説明しています。3537
  • 実行中のサブエージェントを制御。 delegate_taskに制御アクションが追加されました。実行中の子エージェントを一覧表示し、途中で指示を修正して軌道修正したり、早期に停止して途中までの結果を保持したりできます。子エージェントの出力はJSONスキーマに照らして検証でき、委任ごとのコストも結果に表示されます。デフォルトの上限は、サブエージェントあたり250反復、同時実行する子エージェント10個に引き上げられました(v0.19.0でmax_async_childrenに代わって導入された統一上限です)。3538
  • MCPの管理センター。 MCPサーバーとカタログが、デスクトップの1つのページに統合されました。ドラッグ操作や「何でも貼り付け」によるインポート、ツール呼び出しが失敗する前に再認証を促すバックグラウンドのヘルスチェック、サーバー群全体のコスト・使用量を重ねて表示する機能(スキーマの推定トークン数、サーバーごとの30日間の使用量)、明示的な確認を経てMCPサーバーをインストールするhermes://ディープリンクを備えています。MCP連携をご覧ください。35
  • CLIの機能を大幅に拡充。 Ctrl+Pであいまい検索に対応したコマンドパレットが開きます(/paletteからも利用できます)。/modelの選択画面では入力に応じて候補が絞り込まれ、/statusには推論モード、承認待ちの操作、コンテキスト使用量が表示されます。ステータスバーには、キャッシュヒット率、レイテンシー、毎秒のトークン数をリアルタイムで表示でき、項目ごとに表示を切り替えられます。さらに、全体の緊急停止、セッションの固定・解除、入力欄のプレースホルダーの切り替え、ターミナルのペットも追加されています。名称について1点補足すると、リリースではドライラン用の承認チェッカーをhermes approval-checkとして紹介していますが、タグ時点でのコマンドはhermes approvals testです。approval-checkサブコマンドは存在しません。3540
  • エージェントがデスクトップアプリのブラウザーを操作。 アプリ内ブラウザーは、エージェントが眺めるだけのウィンドウではなくなります。Hermesが直接ページを移動し、クリックし、内容を読み取れるようになりました。ページはシステムのブラウザーで開くこともでき、リンクのコンテキストメニューも一通り利用できます。35
  • 6つの新プロバイダーとモデルカタログの拡充。 Meta Model API(Muse Spark)、CommandCode、Tencent TokenPlan、Nebius Token Factory、Ramp Router、Actual Computerが加わりました。このうち3つ(Meta AI、CommandCode、Actual Computer)は、以前のロールアップ期間中に導入済みで、すでにプロバイダー一覧表に掲載していました。今回、一覧表にTencent TokenPlan、Nebius Token Factory、Ramp Routerを追加し、ドキュメントに新たに記載されたAlibaba Token PlanのSKUも加えています。カタログにはGLM-5.3-Flash、qwen3.8-max/flash、Gemini 3.7 Flash、MiniMax M3の無料版、Nemotron 3.5 Lightning、Muse Spark 1.2が追加されました。構造面でも2つの変更があります。config.yamlのmodel_overridesを使えば、リリースを待たずに任意のモデルのコンテキストウィンドウや料金を上書きできます。また、プロバイダーをpipでインストールするパッケージとして配布し、エントリーポイント経由で検出できるようになりました。選択時のチェックを担う統一レジストリも導入され、利用者のデータを学習に使うモデルについて、すべての選択画面で警告が表示されます。3536
  • 全般的なセキュリティ強化。 保護されたエージェント指示ファイル(AGENTS.md、skill、メモリストア)への書き込みには、常に承認が必要になりました。これにより、プロンプトインジェクションを受けたエージェントが、自身の常設指示をひそかに書き換えることを防ぎます。機密情報のマスキングも徹底的に見直され、ターミナルエラー、.envの読み取り、checkpoint、ACPログから秘密情報が漏れる経路が塞がれました。承認システムはWindowsの破壊的コマンドも認識するようになっています。macOSでは、安定したTCC署名ID(hermes desktop --setup-tcc-identity)により、更新後も付与済みの権限が維持されます。また、上流での侵害を受け、BlenderのMCPカタログ項目とskillが削除されました。タグ時点での詳細は、セキュリティ強化をご覧ください。3539
  • gatewayの成熟。 Slackにはネイティブのライブカード(実際のストリーミング返信と、任意で有効にできる計画・タスクカード)と、送信リンクのプレビュー抑制機能が加わりました。Telegramには、@botnameからすべてのコマンドとskillを検索できるインライン選択機能が追加され、Telegramのコマンドメニューの上限を回避できます。リレー経路も強化されました(ネイティブのプラグイン初期化、下書きのストリーミングを伴うライブカード操作、セッション区間の分割、ボイスメモのSTT復旧)。gateway制御ソケットにより、エージェント群を扱うクライアントからgatewayに問い合わせたり、アップデーターがプロセスツリーを強制終了せずに正常に一時停止したりできます。また、ターンの回収処理は、ウォッチドッグが作動した際に応答不能なワーカーのスタックを取得します。35
  • skillの大幅な拡充。 生産性向上のために再活用された8つのskill(document-to-action-items、meeting-action-items、email-inbox-triage、github-issue-to-pr、weekly-review-planning、competitor-news-monitor、product-price-monitor、social-media-content-calendar)、HARから生成するAPIクライアント(「Webサイトを1回観察すれば、その後はブラウザーなしで背後のAPIを直接呼び出せます」)、publish-site、session-librarian、blocked-page-recovery、merge-reconciler、plan-interrogation、作成時に助言を表示するSKILL.mdリンターが追加されました。35

この期間に取り消された変更(リリースには含まれません): Model Councilモード(/council)とDCP context engineは、どちらも導入後に取り消されました。WS専用のgatewayサーバー(#94245)もマージ後に取り消されたため(#96118)、デスクトップの起動経路には引き続きFastAPIが残っています。ただし、シーケンス番号付きのイベント再生(#94219)、つまりWebSocket経由で欠損なくデスクトップを再接続する機能は、リリースに含まれています。Electronは40.10.2に戻されました。v0.20.xの各期間を扱ったコミュニティの記事などで、これらの取り消された機能が紹介されていても、今回のリリースには含まれません。35

更新方法は変わりません。既存のインストールではhermes updateを使い、新規インストールではシェルインストーラーを使います。下にあるHeraldリリース内のロールアップサブセクションには、どの期間に何が導入されたかをタグごとに引き続き記録しています。35

v0.20.0の新機能(The Herald Release)

Hermes Agent v0.20.0(タグ v2026.8.3、2026年8月3日)は、一連の変更がv0.21.0にまとめられる前の機能リリースです。v0.20.1(8月13日)とv0.20.2(8月16日)は、その安定化を目的としたタグです。さらに、v0.20.3(タグ v2026.8.16.2、8月17日公開)、v0.20.4(タグ v2026.8.18、8月18日)、v0.20.5(タグ v2026.8.19、8月21日公開)、v0.20.6(タグ v2026.8.27、8月27日)でも、それぞれの期間に新機能を盛り込みながら、変更をまとめたリリースが続きました。詳細は以下の小節をご覧ください。v0.19.0以降の期間には、650人以上の貢献者による約3,650件のコミット、1,400件のマージ済みPR、1,200件のクローズ済みIssueが含まれます。69

3つの変更により、このガイドの以前のバージョンで案内していた手順が通用しなくなりました。 まず次の点を確認してください。

  • Node 26が必須になりました。 インストーラーは NODE_VERSION="26" に固定され、古いランタイムでは「Node.js … は古すぎます(HermesにはNode >=26が必要です)」というエラーで処理を拒否します。インストーラー、heal、upgrade のすべてで、この要件が適用されます。ドキュメントサイトのインストールページには今もNode v22と記載されていますが、インストーラースクリプトとリリースノートのほうが新しく、判断の根拠となる情報源です。69
  • pipとHomebrewは、単に非推奨になったのではなく、提供が終了しました。 原文には「brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels).」と明記されています。現在もpipやbrewでインストールしたものを使っている場合、その経路では今後リリースを受け取れません。69
  • ツール呼び出しの反復回数のデフォルト上限が90から500に変わりました。 長時間の自律実行が人為的な制限に阻まれなくなり、以下に示す予算逼迫の各しきい値も、新しい上限を基準に計算されます。read_file のデフォルトも500行から2,000行に変わりました。69

そのほかのリリース内容は次のとおりです。

  • 音声による対話。 発話中の割り込みに対応したストリーミングTTSと、デバイス上でのウェイクワード検出が加わりました。69
  • A2A v1.0。 エージェント間通信プロトコルのプラグインが追加され、Issue #514で長らく要望されていた機能が実現しました。69
  • 署名付き送信Webhook。 以前の hermes webhook は受信専用でしたが、v0.20.0ではセッション、ターン、ツールの各イベントに対応する、HMAC署名付きの送信ライフサイクルWebhookが追加されました。69
  • 根拠に基づく引用。 ファクトチェックモードを備えた新しいskillが追加されました。69
  • 上級ユーザー向けのCLI機能強化。 !command はモデルのターンを消費せず、シェルコマンドを即座に実行します。/init はプロジェクトを走査し、AGENTS.md を作成または更新します。/diff はどのインターフェースからでも、ステージ済みの変更、すべての変更、またはセッション内の変更を表示します。/context はコンテキストウィンドウの使用内容を詳しく示し、/focus は出力を絞った表示を提供しつつ、非表示の行も再表示できます。Ctrl+Sでは書きかけのプロンプトを一時保存できます。hermes import-agent を使えば、Claude CodeまたはCodex CLIの設定を1つのコマンドで移行できます。69
  • シークレット関連機能の追加。 すべての保管庫と組み合わせられるコマンドヘルパー方式のシークレット取得元、対処方法がわかる起動時エラーを伴う1コマンドでのトークンローテーション、Bitwarden向けの任意で有効にできる暗号化された緊急用キャッシュ、profileホームごとにスコープを限定した保管庫からのキー注入、そして config.yaml とMCP設定間での ${env:VAR} SecretRefの同等サポートが加わりました。後述する3経路の認証モデルは変わりません。69
  • ウォームスタートの高速化。 hermes -w のコールドスタートが約14秒から1.8秒に短縮されました。69
  • デスクトップがプラットフォームへと進化。 バージョン管理されたカードとサンドボックス内のライブプレビューを備えたアーティファクト、最初のデスクトッププラグインとしてKanbanを採用したPlugin SDK、すぐに入力を始められるグローバルホットキー、複数のGUIウィンドウ、SSHリモートバックエンドモード、RFC 8252に準拠したネイティブサインインが加わりました。69

v0.20.3、v0.20.4、v0.20.5、v0.20.6の累積リリース(8月17〜27日)

v0.20.0以降は、変更をまとめてタグを付けるリリースが高頻度で行われ、安定化にとどまらない内容となりました。4つのリリースはいずれも、整理されたリリースノートの公開を後に回し、「この期間の完全なリリースノートは、内容を整理したうえでv0.21.0とともに公開する」と案内していました。そのノートは、現在ではv0.21.0で公開されています。上記のv0.21.0の新機能が、この期間全体を整理した記録です(リリースでも、各期間の変更を「ここにすべて記載している」と明言しています)。以下のブロックは、各タグの公開当時の記録として残しています。整理版のノートではまとめられている変更について、どのタグで何が導入されたかを確認できます。68233035

v0.20.3(v0.20.2以降、約250件のコミット、約125件のPR):

  • MCP 2.x SDKへの移行と、2026-07-28版ステートレスプロトコルへの対応。 Hermesは現行世代のMCP SDKへ移行し、プロトコルのステートレス版に対応しました。68
  • Bot Modeを同梱プラグインとして提供します(hermes-bots)。チームメイト間連携の中核プロトコルを備えています。68
  • CommandCodeプロバイダープラグインがプロバイダーカタログに加わりました。68
  • コンピューター操作向けのCua Driver 0.20ランタイム契約に加え、サブプロセスのPythonランタイムの管理責任を明確にして堅牢性を高めました(PYTHONHOME/PYTHONPATHの分離)。68
  • 信頼性:cronスケジューラーの自己修復(EMFILEからの復旧、古い実行権取得状態の整合、停止したジョブの再実行準備)、セッション引き継ぎ時のデータ損失の修正、デスクトップからリモートgatewayへの接続の自己修復、エコシステムからの各種機能の移植(プラグインインストール時のセキュリティスキャン、/worktree、/rollback での手動編集の保持、UTF-16ファイルの読み取り)が含まれます。68

v0.20.4(v0.20.3以降、約146件のコミット、約74件のPR):

  • デスクトップのガラス調デザイン:マットなガラスと半透明の表現が改良され、曇り具合の選択機能とmacOS向けの事前選択設定が加わりました。68
  • SESSIONS|BOTSをタブで切り替えるサイドバーが加わり、ボットごとに表示と非表示を切り替えられます。Bot Modeのグループチャットも修正されました(メンバーの長時間ターン、Markdownの描画、マシン間ルーティング)。68
  • skillインストール時のNVIDIA SkillEvaluator Tier 1による助言目的のスキャン:skillをインストールすると、ライセンスとセキュリティのチェックが実行されます。68
  • cronのメディア送信の堅牢化(設定可能なタイムアウト、手動実行時の添付ファイル、実行漏れの可視化)、SessionDBのイベントループスレッドと競合の修正、hermes update での退避されたブランチの状態の正確な提示、KanbanのOSネイティブ通知が含まれます。68

v0.20.5(v0.20.4以降、約746件のコミット、約323件のPR):

  • キー不要のWeb機能:新規インストール直後から、APIキーなしでWeb検索を利用できます。5社の無料サービスを順番に使い、障害時には次のサービスへ切り替えます。23
  • CLIの使い勝手を改善:あいまい検索に対応した /model 選択画面、Ctrl+Pのコマンドパレット、情報が充実した /status が加わりました。23
  • Bot Modeの機能拡充:グループルームのスレッド、折りたためる会話の要約、丸みのある顔のアバター、ドラッグ&ドロップによるPDFやファイルの添付が加わりました。23
  • フリートとworktreeの管理ツール:hermes update の実行結果記録、hermes update --plan(リリースノートでは「フリートの --plan 検証」と呼ばれていますが、このフラグは fleet コマンドではなく hermes update に属します。パーサーのヘルプによると、「更新計画を表示し、何も変更せずに終了」します)、hermes worktree list/prune が加わりました。2327
  • cronジョブに永続メモリとジョブごとの推論量設定が追加されました。 さらに、Composioの評価結果に基づく実行規律と実行時の停滞防止機構、複数の質問による確認、認証不要のopencode-freeプロバイダー、デスクトップのパフォーマンス改善(初期描画を優先するBot Modeのハイドレーション、両レンダラーへのReact Compiler導入)も含まれます。23

v0.20.6(タグ v2026.8.27、8月27日 – v0.20.5以降、約1,313件のコミット、約525件のPR):

このリリースは、自らを「パッチリリースです。このタグは、v0.20.5以降にマージされた約525件のPRを、下流の利用者向けに安定したタグ付きリリースとしてまとめたものです」と明確に説明しています。その説明によると、対象期間の変更は約1,557ファイルにわたる約1,313件のコミット(+177,113 / −21,682)、約525件のマージ済みPRに及びます。30 説明に挙げられた主な項目は次のとおりです。

  • 同意を得たうえで普段のprofileを使うブラウジング – ローカルでのブラウジングに、既定のChromium profileを利用できます。Windowsでは、承認を得てからブラウザーを閉じるフローを備えています。30
  • デスクトップのBrowserが独立したOSウィンドウになりました。 さらに、管理機能を備えたSSHリモート更新エンジンと、フリート内のprofileを並べるレールが加わりました。30
  • リモートMCPカタログの拡充:Cloudflare、Grafana Cloud、Better Stack、Railwayなど、実際の接続を検証済みのベンダー運営サーバーが50件以上含まれます。30
  • 保存済みシークレットをOSキーチェーンで暗号化する任意設定 – macOS Keychainの確認プロンプトが起動のたびに表示されなくなります。30
  • 各選択画面に新しいモデルを追加:GLM-5.3-Flash、MiniMax M3 free、MiniMax H3 Max videoが加わりました。30
  • web_search/web_extract のTTL付き結果キャッシュと、語幹処理に対応した複数クエリの tool_searchが追加されました。30
  • Lean-tail圧縮がデフォルトになりました。 タグ公開時点の設定は、後述のコンテキスト圧縮で説明しています。3031
  • ターミナルバックエンドがプラグイン方式になりました。 ターミナルバックエンドをご覧ください。3032
  • 更新ツールとフリート管理が実態に即した動作に改善されました:更新ツールはgatewayのプロセスツリーを強制終了する代わりに、制御ソケット経由で一時停止します。また、イメージやパッケージで管理されるインストールでは、安全でないインプレース更新を拒否します。30
  • cronの永続化されたインシデントへの確認応答と、コードのバージョン不整合による失敗の明確化、Slackのリンク展開制御、共有Dockerコンテナー識別情報が含まれます。30

更新方法は変わりません。既存のインストールでは hermes update を実行し、新規インストールではシェルインストーラーを使います。682330

v0.19.0の新機能(Quicksilverリリース)

Hermes Agent v0.19.0(タグv2026.7.20、2026年7月20日)は、伝令の神の速さにちなんで名付けられました。リリースの中心となるのは応答速度の向上で、すべてのプラットフォームで初回ターンの最初のトークンが届くまでの時間を約80%短縮しています。さらに、ターミナルでの請求管理、パスワードマネージャーからのシークレット取得、スマート承認の標準化、サブエージェントの動作確認、クラッシュに耐える応答配信も加わりました。v0.18.0以降の開発規模はプロジェクト史上最大で、コミット約2,245件、マージされたPR約1,065件、クローズされたIssue約3,300件、コミュニティの貢献者450人以上に達しています。70

  • あらゆる環境で、最初のトークンが届くまでの時間を約80%短縮。 コールドスタート時の送信から処理開始までの時間が、CLI、gateway、TUI、デスクトップ、cronのいずれでも約4.3秒から約0.9秒に短縮されました。Discordの機能検出をクリティカルパスから外し、Ollama以外と判明しているプロバイダーではOllamaの検出を省略し、エージェント初期化時のブロッキング処理を取り除いています。体感上の待ち時間も改善され、推論モデルはデフォルトで思考過程をリアルタイムにストリーミングするようになりました(display.show_reasoningがON)。応答欄も行単位ではなくトークン単位で描画されます。70
  • デスクトップとTUIの描画を大幅に改善。 デスクトップアプリでは約20件のPRにわたる高速化を実施しました。ブロック単位の差分字句解析により、ストリーミングMarkdown分割処理のCPU使用量を約14分の1に削減しています。レビューペインの差分表示を仮想化し、大量の会話履歴があってもセッションをすばやく切り替えられるようになりました。トークンごとにサイドバーやツール行を再描画する処理も廃止しています。TUIでも、ストリーミングされるMarkdownをブロック単位で逐次描画するようになりました。70
  • pipとHomebrewによるインストールを非推奨に。 どちらの方法も「サポート対象外の旧方式」とされ、廃止が予定されていました。その後、v0.20.0で廃止されています。brewとpip/PyPI wheelによる配布は終了し、現在サポートされているのはシェルインストーラー、Docker、Nixです。7069
  • パスワードマネージャーからシークレットを取得可能に。 新しいプラグイン対応のSecretSourceインターフェースは、読み込み時にBitwardenや1Password(op://参照)からシークレットを取得します。複数の保管庫を同時に有効にでき、優先順位が明確に定まり、競合の警告や変数ごとの取得元の確認にも対応しています。これにより、APIキーを平文の.envに保存する必要がなくなりました。今後の保管庫プロバイダーもプラグインとして追加できます。70
  • スマート承認がデフォルトに。 Hermesが要確認と判定されたコマンドを実行しようとすると、毎回ユーザーに確認する代わりに、独立したLLMレビュアーが評価します。それぞれの判定は、そのコマンドだけに適用されます。ユーザー定義の拒否ルールはYOLOモードでも一致するコマンドをブロックし、/deny <reason>は拒否理由をエージェントに伝えて方針修正を促します。また、プラグインのpre_tool_callのapproveアクション(ルールキー対応で再導入)を使うと、ツール呼び出しを人間による承認に回せます。70
  • ターミナルでの請求管理:/subscriptionと/topup。 ターミナルからNous Portalのプランを管理できます。現在のプランと残りの利用枠を確認し、アップグレードの正確な料金やダウングレードの適用時期を事前に確認してから変更を適用できます。取り消しにも対応しています。デスクトップアプリにも同等の請求設定タブが追加されました。70
  • サブエージェントの作業を確認でき、完成した回答も失われません。 delegate_taskによるタスク送信では、サブエージェントの起動直後からtail -fで追跡できるリアルタイムの記録ファイルが返されます。すべてのツール呼び出し、結果、ストリーミング応答が、子エージェントごとに1つの読みやすいログに記録されます。バックグラウンドで委任したタスクの完了情報は再起動後も保持されます。また、gatewayの最終応答はstate.dbの配信義務台帳に記録され、送信中にgatewayが停止した場合は次回起動時に再配信されます。設定オプションのmax_async_childrenは非推奨となり、委任処理全体で統一された同時実行数の上限に置き換わります。70
  • 1つのgatewayで複数のprofileに対応。 1つのボットトークンを共有する多重化gatewayで、特定のギルド、チャンネル、スレッドをそれぞれ異なるprofileに振り分けられます。各profileの設定、skill、メモリ、シークレットは完全に分離され、GATEWAY_MULTIPLEX_PROFILESによる上書きも可能です。ルーティングのインデックスはstate.dbに移り、sessions.jsonは任意で利用する旧方式のミラーとなりました。70
  • プロバイダーとモデルを多数追加。 Fireworks AIが正式に統合され、コスト見積もりに対応し、プロバイダー選択画面の2番目に表示されるようになりました。DeepInfraとUpstage Solarも加わっています。モデルカタログにはGPT-5.6(Sol/Terra/Luna + Pro、全機能に統合済み)、grok-4.5(一般提供)、kimi-k3(kimi-k2.xは廃止)、全面的に統合されたClaude Sonnet 5が追加されました。プロバイダーごとのenabled: falseフラグとexcluded_providers設定により、使わないプロバイダーを/modelの選択候補と解決処理から除外できます。70
  • 推論の強度を柔軟に調整可能に。 新しい推論強度の段階としてmaxとultraがすべてのインターフェースに追加されました。設定によるモデルごとの上書き、MoAプリセット内のスロットごとの指定(アドバイザーはじっくり推論し、統合役は高速に処理)、補助モデルのタスクごとの指定に対応しています。CLIでは、セッション内に適用される/reasoningも使えます。70
  • CLIとMCPの機能拡充。 hermes sessions exportはMarkdown、Quarto、HTML、プロンプトのみ、Hugging Faceトレースの各形式で出力でき、任意の--redact指定で機密情報を除去できます。/model --onceは1ターンだけモデルを変更でき、スラッシュコマンドによるskill呼び出しは組み合わせて使えます(/skill-a /skill-b do XYZ)。--safe-modeはトラブルシューティングを支援し、hermes config get/unsetの追加で設定管理も充実しました。hermes serveは本格的なヘッドレスバックエンドとなり、MCPツールはmcp__server__toolの命名規則を採用しています。70

v0.18.xからアップグレードする場合、まず注意したい変更が2つあります。pipまたはHomebrewによるインストールには、サポート対象外の旧方式であるという警告が表示されるため、1行で実行できるインストーラーへ移行してください。また、max_async_childrenは非推奨となり、委任処理全体で統一された同時実行数の上限に置き換わります。それ以外はすべて機能追加です。アップグレードの主な利点は、初回ターンの待ち時間を約80%短縮する高速化、スマート承認、そして完成した回答をクラッシュから守る配信台帳にあります。


v0.18.0の新機能(Judgmentリリース)

Hermes Agent v0.18.0(タグv2026.7.1、2026年7月1日)は、「判断」にちなんで名付けられました。エージェントが成功を宣言するだけでなく自ら作業結果を検証すること、そして複数モデルによる推論の過程を実際に確認できることを表しています。P0/P1の未対応項目もすべて解消し、12日間で最優先の項目を約692件解決しました。22

  • Mixture-of-Agentsを正式なモデルとして統合。 MoAをすべてのインターフェースで、ほかのモデルと同じように選択できるようになりました。複数モデルによる推論も可視化され、各参照モデルの出力全文がラベル付きの個別ブロックにリアルタイムで表示されます。統合された回答だけを受け取るのではなく、各モデルの思考の流れを追えます。22
  • /goalの完了条件。 エージェントは目標の完了を報告する前に、プロジェクトのチェックを実行して自ら作業結果を検証します。成功を宣言するだけでなく、自分自身にも判断基準を適用します。22
  • /learn — 説明するだけでskillに。 ワークフローを説明すると、再利用可能なskillに変換できます。生成されたskillは、リポジトリのCONTRIBUTING.mdの規約に自動的に準拠します。22
  • /journeyのタイムライン。 メモリとskillの変化を時系列で視覚的に確認でき、編集も可能です。デスクトップにはメモリグラフも追加されました。22
  • バックグラウンドで複数のサブエージェントに展開。 会話を止めずに、複数のタスクを委任して同時に実行できます。v0.17.0では1つだったバックグラウンドのサブエージェントが、複数で動作するようになりました。22
  • デスクトップのProjects。 コーディング向けのProjectsが正式に統合され、プロジェクト/リポジトリ/レーンで整理できるようになりました。22
  • ゼロまでスケールダウンできるgateway。 gatewayは待機中に休止し、処理中のリクエストを完了させる調整によってシームレスなデプロイに対応できます。Hermesを常時稼働のサービスとして運用する場合に役立ちます。22
  • Google Vertex AIに対応。 GCPサービスアカウント経由でGeminiを利用できるようになり、プロバイダーカタログに加わりました。OAuth2トークンの自動更新にも対応しています。22
  • エディターを開く/promptコマンド。 $EDITORを開いて複数行のプロンプトを作成できます。入力欄で苦労して編集する必要はありません。22

v0.17.xからアップグレードする場合、CLIに互換性を損なう変更はありません。アップグレードの主な利点は、完了条件による目標達成の自動検証、各モデルの推論を確認できるMoAの正式統合、そしてワークフローをskillとして保存できる/learnです。


v0.17.0の新機能(The Reach Release)

Hermes Agent v0.17.0(タグ v2026.6.19、2026年6月19日)の名称は、エージェントが対応する範囲の広がりに由来します。新しいメッセージングチャネルやモデルプロバイダーに加え、デスクトップとダッシュボードの操作機能も充実しました。v0.16.xに機能を追加するリリースで、CLIのインターフェースに変更はありません。21

  • 新しいメッセージングチャネル。 iMessageは、Photon Spectrum(デバイスコード方式のOAuth、hermes photon login)を通じて、Macの中継なしで利用できるようになりました。WhatsApp Business Cloud APIはMeta公式のアダプターで、ブリッジプロセスが不要になります。SimpleXにはグループ、ネイティブ添付ファイル、テキストのバッチ送信、自動承認が追加されました。さらに、設計上の契約でプライバシーを保証する起動通知チャネルを備えたRaftが、同梱のプラットフォームプラグインとして加わりました。21
  • 新しいモデルとプロバイダー。 カタログにz-ai/glm-5.2(1Mコンテキスト)、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra、grok-composer-2.5-fast(xAI OAuth経由で利用するCursorのモデル、200kコンテキスト)が追加されました。xAIのデフォルトはgrok-build-0.1に変更され、Anthropicの適応型モデルは新しい思考処理の仕様に従うようになりました(reasoningフィールドは送信しません)。21
  • デスクトップとダッシュボード。 デスクトップには、委任した作業を「watch-windows」でリアルタイムにストリーミング表示するバックグラウンドサブエージェント(delegate_task(background=true))、Composerのモデル選択、変更可能なキーボードショートカット、OS標準の通知、スレッドごとの入力欄の下書き、VS Code Marketplaceのテーマ、日本語と繁体字中国語のUIが追加されました。ダッシュボードには、本格的なprofile作成機能(config.yamlを編集せずにモデル、skill、MCPを設定)、全体共通のprofile切り替え、セキュリティスキャンを備えて刷新されたSkills Hub、Automation Blueprints(フォーム、スラッシュコマンド、会話、ドキュメントで使えるパラメーター付きテンプレート)、OAuthの認証ゲートで未認証時に401を返す安全なログイン機能が加わりました。21
  • skillとツール。 image_generateは、対応するすべての画像プロバイダーで、新規生成に加えて元画像の編集と変換もできるようになりました。memoryツールにはoperations配列が追加され、1回の呼び出しで追加・置換・削除をアトミックに一括実行できます。新しいsimplify-code skillでは、チェスタトンのフェンスに基づくリスク区分に応じて、3つのエージェントが並列でレビューとコード整理を行います。また、3状態のwrite_modeは真偽値のwrite_approvalに置き換えられました。21
  • アーキテクチャ。 バックグラウンドサブエージェントは即座にハンドルを返し、結果を新しいターンとして会話に戻します。MCPの入力要求ハンドラーによりツール呼び出しの途中で確認できるようになり、後から接続されたMCPツールもターン間で公開されます(キャッシュの安全性を維持します)。cronは、Chronosのマネージドcronプロバイダーに対応するプラグイン式のCronSchedulerになりました。新しいManagedスコープ(/etc/hermes)では、管理者がユーザーには変更できない設定を固定できます。複数のgatewayを組み合わせる構成向けに、Gateway-Gatewayリレーも追加されました。21
  • 新しいコマンド。 /version、/billing(ターミナルでの対話型の請求管理)、hermes photon login(iMessage認証)、hermes curator run --consolidateが追加されました。統合処理は明示的に有効化する方式になったため、通常のバックグラウンド整理ではトークンを消費しません。21
  • セキュリティ。 v0.17.0では、シェルエスケープによる拒否リストの回避を防ぎ、承認モジュールが欠けている場合や独自ポリシーを持つgatewayアダプターでは、安全側に倒して処理を拒否します。cronジョブスクリプトのサブプロセス用の環境をサニタイズし、リクエストのデバッグダンプからシークレットを伏せ、MCPのstdio設定で情報流出につながるパターンを検査します。また、CVEへの対応としてurllib3とPyJWTを更新しています。21

v0.16.xからアップグレードする場合、CLIに互換性を損なう変更はありません。同じエージェントに新しいチャネル、モデル、インターフェースが加わります。中継不要のiMessageアダプター、公式WhatsAppアダプター、管理者向けのManagedスコープが、アップグレードの主な理由となります。


v0.16.0の新機能(The Surface Release)

Hermes Agent v0.16.0(タグ v2026.6.5、2026年6月5日)の名称は、CLIを中心に据えたエージェントに、新しい操作インターフェースが加わったことに由来します。最大の変化は、Hermesがターミナル専用ではなくなったことです。20

  • ネイティブデスクトップアプリ。 Hermes Desktopは、macOS、Linux、Windows向けの新しいElectronアプリで、ワンクリックでのインストールとアプリ内の自動更新に対応しています。ストリーミング表示のチャットウィンドウ、ファイルのドラッグ&ドロップ、クリップボードからの画像貼り付け、Cmd+Kパレット、アーカイブと検索に対応したセッション一覧、ステータスバーのモデル選択機能を備えています。安全なWebSocket経由でリモートのHermes gatewayに接続し、OAuthまたはユーザー名とパスワードで認証できます。profileごとにリモートホストを設定でき、複数のprofileでセッションを同時に実行しながら、profileをまたぐ@session参照で連携させることも可能です。デスクトップUIには、型付きのi18nレイヤーによる完全な簡体字中国語(简体中文)訳も含まれています(display.languageで設定し、デフォルトは引き続き英語です)。20
  • ブラウザー管理パネル。 ローカルのWebダッシュボードは、状態表示から本格的な管理パネルへと進化しました。有効・無効を切り替えられるMCPカタログ、認証情報の管理、Webhookとフックの作成、メモリ設定、gatewayの操作に加え、更新前の確認とワンクリックのDebug Shareを備えたSystemページを利用できます。新しいChannelsページでは、gatewayのすべてのメッセージングプラットフォーム(Telegram、Discord、Slackなど)をブラウザーから設定できます。認証も差し替え可能になり、ユーザー名とパスワードでのログイン、汎用のセルフホスト型OIDCプロバイダー、セルフホスト型OAuthクライアント向けのhermes dashboard register、リフレッシュトークンによるセッションローテーションに対応しました。20
  • 新しいCLIコマンドとスラッシュコマンド。 /undo [N]は、直近のN回のユーザーターンを論理削除し、入力欄への再入力を伴って巻き戻します。CLI、TUI、各メッセージングプラットフォームで利用できます。デフォルトのインターフェース(cliまたはtui)を設定できるようになり、--cliで上書きすることも可能です。TUIには統一された/modelコマンドとSessionsオーバーレイが加わりました。hermes portalはNous Portalの初期設定フローを呼び出す、わかりやすい別名です。初回起動時にはQuick SetupとFull Setupを選べるようになり、診断コマンドとしてhermes prompt-sizeとhermes sessions optimizeも追加されました。20
  • 新しいモデルとプロバイダー。 モデル選択にdeepseek-v4-flash、MiniMax-M3(1Mコンテキスト、ネイティブのMiniMaxプロバイダー)、qwen3.7-plus(Nous + OpenRouter)、gemini-3.5-flash(Gemini OAuth + APIキー)が追加されました。正式に対応したxAI Grok OAuthプロバイダーがデスクトップランチャーに加わり、すべてのインターフェースでモデルのあいまい検索が可能になりました。複数のエンドポイントを持つプロバイダーは1行にまとめられ、カタログの更新間隔は1日ごとから1時間ごとに変更されています。20(その後、v0.21.1で更新間隔が再び変更され、モデル選択のリモートカタログは20分ごとに更新されます。設定項目はmodel_catalog.ttl_minutesです。46)
  • skillの整理と段階的な公開。 デフォルトのskillセットから重複や使われていないskillを削除し(Spotifyはネイティブプラグインへ、Linearはhermes mcp install linearへ移行し、古くなった項目もいくつか削除)、より多くのskillを任意で追加する方式に変更しました。また、フロントマターにenvironments:による関連性の判定(kanban/docker/s6)を追加し、特定の環境向けのskillは要求されるまでインデックスに含めないようにしています。NVIDIA/skillsは、OpenAI、Anthropic、HuggingFaceと並ぶ、Skills Hubのデフォルトの信頼済み配信元になりました。MCPとプラグインのツールには、範囲を限定した段階的なツール公開が追加されています。また、トークンを取得できていないのにOAuthの成功を報告していたMCPの不具合も修正されました。20
  • セキュリティ。 v0.16.0では、CVE-2026-48710(BadHost)に対応する修正済みのStarlette(≥1.0.1)にバージョンを固定しました。非同期処理ではSSRF対策のURL検査をイベントループの外へ移し、サブプロセスの環境変数からBedrock推論用のBearerトークンを除去しています。また、ファイルの安全性を保つ読み取りガードにbws_cache.jsonを追加し、危険なパターンの一覧にdocker restart/stop/killを追加したほか、審査済みskillの内容に含まれる不可視のUnicode文字をサニタイズします。このリリースではP0の問題を2件、P1の問題を62件解決し、そのうち16件にはセキュリティタグが付いていました。20

v0.15.xからアップグレードする場合、CLI自体に互換性を損なう変更はありません。同じエージェントにインターフェースとプロバイダーを追加するリリースです。ターミナルを使わないユーザー向けにHermesを運用したい場合や、ブラウザーからリモートのgatewayを管理したい場合は、デスクトップアプリと管理パネルがアップグレードの理由になります。

v0.14.0の新機能(The Foundation Release)

v0.14.0は、1つの目玉機能よりも、セットアップの手間を減らし、Hermesを実行できる環境を広げることに重点を置いています。19 運用上の主な変更点は次のとおりです。

  • インストールと起動が軽量になりました。 PyPIからpip install hermes-agentでインストールでき、重いアダプターは初回使用時に必要に応じてインストールされます。起動時の処理も十分に後回しにすることで、コールドスタートを約19秒短縮しました。(その後、v0.19.0でpipによるインストールは非推奨になりました。インストールをご覧ください。)
  • サブスクリプションをローカルのAPIエンドポイントとして使えます。 hermes proxyは、Claude Pro、ChatGPT Pro、SuperGrokなどのOAuth認証を利用するプロバイダーを、Codex、Aider、Cline、Continueといったツール向けのOpenAI互換ローカルエンドポイントに変換します。
  • gatewayの対応範囲が広がります。 LINEとSimpleX Chatがgatewayに加わり(ドキュメントのプラットフォーム比較表では、タグv2026.8.31時点で28プラットフォームが掲載されています。この数に何が含まれるかはメッセージングgatewayのセクションで説明しています)、Microsoft Teamsも一連の処理を通じて利用できるようになりました。Discordの過去の履歴の取り込みはデフォルトで有効になり、TelegramとDiscordのclarifyによる確認にはネイティブのボタンが使われます。
  • 書き込み時の検証が改善されます。 編集後、次のターンに進む前に、ターンごとのファイル変更の要約と、言語サーバーによる意味解析の診断結果をHermesが提示できるようになりました。これにより、根拠に基づいて作業するエージェントに一歩近づきます。
  • デスクトップ操作とメディア用ツールが拡充されます。 computer_useは、Anthropic以外のプロバイダーでもcua-driver経由で動作します。video_generateは差し替え可能なバックエンドを通じて統一され、vision_analyzeは画像を実際に認識できるモデルに生のピクセルデータを送信します。

インストール

1行のコマンドで実行できるインストーラーが、サポート対象のインストール方法です。Python、uv、Node.js、ripgrep、ffmpegの導入から、リポジトリのクローン、仮想環境の作成、グローバルなhermesコマンドの設定まで処理します。7

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

v0.19.0以降、pipとHomebrewによるインストールは非推奨です。 v0.14.0で導入されたPyPIパッケージ(pip install hermes-agent)とHomebrew formulaは、現在「サポート対象外のレガシー」インストールとして扱われています。Hermesがこれらを検出すると、すべてのインターフェースで警告が表示されますが、動作はブロックされません。PyPIとHomebrewへの公開も廃止される予定です。pipまたはbrewでインストールした場合は、上記のインストーラーに移行してください。70

Linux、macOS、WSL2、Android/Termuxで動作します(インストーラーはTermuxを自動検出し、テスト済みのAndroid向けバンドルに切り替えます)。7 ネイティブWindowsは、v0.14.0で導入された初期ベータから、現在はTier 1プラットフォームに昇格しています。iex (irm https://hermes-agent.nousresearch.com/install.ps1)でインストールできます。ドキュメントに明記されている注意点として、macOSのサポートはApple Siliconのみで、Intel Macはサポート対象外です。69 ネイティブWindows対応はv0.14.0でPowerShellインストーラーを通じて初期ベータとして追加されましたが、Windowsでの利用環境が成熟するまでは、本番環境には引き続きWSL2のほうが安心して推奨できます。19

完了したら、次を実行します。

source ~/.bashrc    # or ~/.zshrc
hermes              # Start chatting

事前に必要なのはgitだけです。インストーラーはuvを使ってPython 3.11を自動で用意し(sudoは不要です)、Node.js 26(ブラウザー自動化とWhatsAppブリッジ用)、ripgrep、ffmpegも導入します。v0.20.0以降はNode 26が必須の最低バージョンです。これより古いバージョンは使用せず、代わりにHermesが管理するNodeをインストールします。697

インストールの確認

hermes --version    # Check version (global flag; there is no `version` subcommand)
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctorを実行すると、不足しているものと修正方法が具体的にわかります。7 hermes dumpは、GitHubのissueやDiscordのスレッドでサポートを求める際に、出力を貼り付けて使う診断コマンドです。設定全体の概要が、機密情報を伏せたプレーンテキストで出力されます。8

手動インストール

Pythonのバージョン指定、特定の追加機能、Nix/NixOSとの統合など、細かく制御する必要がある場合は、開発元のインストールガイドに手動での手順が詳しく説明されています。7 uv pip install -e ".[<extras>]"で組み合わせて指定できる主な追加機能は次のとおりです。

追加機能 追加される内容
all 以下のすべて
messaging TelegramとDiscordのgateway
cron cron式の解析
cli セットアップウィザード用のターミナルメニューUI
modal Modalのクラウド実行バックエンド
voice CLIのマイク入力と音声再生
tts-premium ElevenLabsのプレミアム音声。ElevenLabs版のtext_to_speechは、呼び出しごとのvoice_idと、公開Voice Libraryまたは自分のアカウントの音声を対象にしたfind_voices検索を受け付けます(v0.22.6のリリース時期)67
honcho AIネイティブのメモリ(Honcho統合)
mcp Model Context Protocol対応
homeassistant Home Assistant統合
acp ACPエディター統合対応
slack Slackメッセージング
pty PTYターミナル対応(対話型CLIツール)
dev pytestとテスト用ユーティリティ
termux テスト済みのAndroid向けバンドル(cron、cli、pty、mcp、honcho、acpを含みます)

Termuxではインストールコマンドが異なります。uv pipではなく、制約ファイルを指定してpipを使います。

python -m pip install -e ".[termux]" -c constraints-termux.txt

これは、Androidで.[all]を指定すると、追加機能のvoiceを通じてfaster-whisperが導入されるためです。faster-whisperが依存するctranslate2のwheelは、Android向けには公開されていません。7


認証とプロバイダー

タグ v2026.9.7 では、hermes_cli/models_catalog_static.py の311行目に、静的な CANONICAL_PROVIDERS エントリーが39件あります(2026年9月の分割でリストが hermes_cli/models.py から移されましたが、エントリー自体に変更はなく、v0.21.0の tencent-tokenplan も含まれています)。このリストは plugins/model-providers/ から自動拡張されます(同梱ディレクトリは39個あり、そのうち actual、alibaba-coding-plan、commandcode、deepinfra、meta-ai、nebius-token-factory、opencode-free、router、upstage の9個には静的エントリーがありません。これらはデフォルトの認証タイプ api_key を使うため、自動拡張で取り込まれます)。ドキュメントのプロバイダーページには、クラウド型・サブスクリプション型のプロバイダー45件とカスタムエンドポイントの行が表にまとめられています。また、ローカルサーバーとセルフホスト型サーバー(Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLM、ClawRouter、および任意のOpenAI互換エンドポイント)についても別途解説しています。26 タグ v2026.9.24 でも静的リストは39件のままですが、plugins/model-providers/ のディレクトリは38個です。キー不要の opencode-free プロバイダーは9月18日に削除されました。OpenCodeの無料枠が、自社クライアント以外からの匿名アクセスを拒否するようになったためです。53 タグ v0.21.6 でも静的リストは39行のままですが、ディレクトリ数は41個になっています。すでに静的リストに行があった lmstudio と tencent-tokenhub にプラグインディレクトリが追加され、静的リストにない solstice が自動拡張で加わりました。55 これらに加えて、カスタムエンドポイントと3種類の認証方式があります。利用環境に合う方式を見つけられるよう、認証に関する機能全体を方式別に整理します。

3つの認証方式

Hermesの各プロバイダーは、次の3つの認証パターンのいずれかに当てはまります。

方式1 — .env に API キーを保存します。 ~/.hermes/.env にキーを設定すると、Hermesが起動時に読み込みます。OpenRouter、AI Gateway、z.ai/GLM、Kimi/Moonshot、MiniMax(およびMiniMax China)、Alibaba Cloud/DashScope、Kilo Code、OpenCode Zen、OpenCode Go、DeepSeek、Hugging Face、Google/Gemini、および大半のサードパーティープロバイダーで使われます。2 v0.19.0以降は、キーを平文ファイルに保存する必要がなくなりました。差し替え可能な SecretSource インターフェースにより、読み込み時にBitwardenや1Password(op:// 参照)からシークレットを取得できます。複数の保管庫を同時に有効化でき、優先順位は一定のルールで決まり、競合時の警告や変数ごとの取得元の追跡にも対応しています。.env はフォールバックとして引き続き使えます。(これは、プロバイダーのキーを1つのトークン経由でまとめて管理する、v0.15.0のBitwarden Secrets Managerブートストラップトークンとは別の仕組みです。SecretSource は平文ファイル自体を置き換えるもので、今後の保管庫プロバイダーはプラグインとして追加できます。)70

方式2 — hermes model または hermes auth で OAuth を使います。 デバイスコードフローを開始してブラウザーを開き、認証情報を ~/.hermes/auth.json に保存します(Claude Code やCodex CLI などのツールから既存の認証情報をインポートすることもできます)。Nous Portal、OpenAI Codex(ChatGPTアカウント)、GitHub Copilot、Anthropic(Claude Pro/Max)で使われます。2 v0.22.5の時期以降、Nousへのサインインはすべて通常のデバイスログインになりました。無料枠のゲストから自分のアカウントへ移行し、結果にはサインインしたユーザーが表示されます。コネクターもゲストセッションを開くのではなく、サインインを案内するようになりました。64

方式3 — config.yaml にカスタムエンドポイントを設定します。 Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLM プロキシ、Together AI、Groq、Azure OpenAI、自分でホストするサーバーなど、任意のOpenAI互換 API で使えます。hermes model → Custom endpoint で一度設定すると、config.yaml に保存されます。2

プロバイダー一覧

この表では、ドキュメントページに掲載されているプロバイダーと、それぞれの具体的な設定手順をまとめています。タグ時点の選択メニューには、ドキュメントより多くのプロバイダーが表示されます(件数は上記参照)。OpenAI互換であれば、カスタムエンドポイントの行にある方法で接続できます。226

プロバイダー 認証方式 設定方法
Nous Portal OAuth hermes model(OAuth ログイン、サブスクリプション制)
OpenAI Codex OAuth hermes model(ChatGPTのデバイスコード、Codexモデルを使用)
GitHub Copilot(v0.22.6 のリリース時期以降は github-copilot プラグイン) OAuth またはトークン hermes model(OAuth デバイスコード)、または COPILOT_GITHUB_TOKEN / GH_TOKEN / gh auth token
GitHub Copilot ACP(同じプラグイン) ローカルサブプロセス hermes model(PATHに copilot CLI が必要で、copilot login も必要です)
Anthropic OAuth または API キー hermes model(Claude Code の認証情報を優先)、または ANTHROPIC_API_KEY、あるいは ANTHROPIC_TOKEN のsetup-token
OpenRouter API キー ~/.hermes/.env に OPENROUTER_API_KEY を設定します
AI Gateway(Vercel) API キー ~/.hermes/.env に AI_GATEWAY_API_KEY を設定します(プロバイダー:ai-gateway)
z.ai / GLM(ZhipuAI) API キー ~/.hermes/.env に GLM_API_KEY を設定します(プロバイダー:zai)
Kimi / Moonshot API キー ~/.hermes/.env に KIMI_API_KEY を設定します(プロバイダー:kimi-coding)。v0.19.0でカタログにkimi-k3が追加されました(kimi-k2.xは廃止)。70
MiniMax(グローバル) API キー ~/.hermes/.env に MINIMAX_API_KEY を設定します(プロバイダー:minimax)
MiniMax China API キー ~/.hermes/.env に MINIMAX_CN_API_KEY を設定します(プロバイダー:minimax-cn)
Alibaba Cloud(Qwen) API キー ~/.hermes/.env に DASHSCOPE_API_KEY を設定します(プロバイダー:alibaba、別名:dashscope、qwen)
Kilo Code API キー ~/.hermes/.env に KILOCODE_API_KEY を設定します(プロバイダー:kilocode)
OpenCode Zen API キー ~/.hermes/.env に OPENCODE_ZEN_API_KEY を設定します(プロバイダー:opencode-zen)
OpenCode Go API キー ~/.hermes/.env に OPENCODE_GO_API_KEY を設定します(プロバイダー:opencode-go)
DeepSeek API キー ~/.hermes/.env に DEEPSEEK_API_KEY を設定します(プロバイダー:deepseek)
Hugging Face API キー ~/.hermes/.env に HF_TOKEN を設定します(プロバイダー:huggingface、別名:hf)
Google / Gemini API キー ~/.hermes/.env に GOOGLE_API_KEY または GEMINI_API_KEY を設定します(プロバイダー:gemini)
Fireworks AI API キー 標準対応のプロバイダーで、モデル選択メニューにはコスト見積もりとキャッシュ料金の列があります。プロバイダー選択メニューでは2番目に配置されました。v0.19.0で追加されました。70
DeepInfra API キー 標準対応のプロバイダーで、連携の堅牢性が強化されています。v0.19.0で追加されました。70
Upstage Solar API キー 標準対応のプロバイダーです。v0.19.0で追加されました。70
xAI(Grok) ネイティブプロバイダー / SuperGrok OAuth API への直接アクセスとモデルカタログを備えた標準対応のプロバイダーです(v0.9.0以降)。v0.14.0でSuperGrok OAuth が追加され、対象アカウントではgrok-4.3のコンテキストウィンドウが1Mに拡大されました。21619 v0.17.0で grok-composer-2.5-fast(xAI OAuth 経由で利用するCursorのモデル、コンテキストは200k)が追加され、xAIのデフォルトが grok-build-0.1 に変更されました。21 v0.19.0でカタログ内のgrok-4.5が一般提供(GA)になりました。70
xAI Custom Voices API キー 音声クローニングに対応したTTSプロバイダーです。v0.13.0で追加されました。config.yaml の tts: 配下で設定し、.env にxAIキーを指定します。18
Xiaomi MiMo ネイティブプロバイダー 設定ウィザードとモデルカタログを備えた標準対応のプロバイダーです。Nous Portalでは、補助タスク向けにMiMo v2 Proを無料で利用できます(v0.9.0以降)。1615
Google AI Studio API キー ~/.hermes/.env に GOOGLE_API_KEY または GEMINI_API_KEY を設定します。Geminiに直接アクセスでき、models.devレジストリ経由でコンテキスト長を自動検出します(v0.8.0以降)。15
Qwen OAuth(Portal) OAuth hermes model → 「Qwen OAuth(Portal)」(プロバイダー:qwen-oauth。ローカルのQwen CLI ログインを再利用する、ブラウザーでのPKCEログインです)。ポータルリクエストに対応した OAuth プロバイダーです(v0.8.0以降)。上記の API キーを使うDashScopeの方式は、v0.14.0でAlibaba CloudからQwen Cloudへ名称が変更されました。既存の設定キーは引き続き使えます。151926
OpenCode Free(削除済み) キー不要 2026年9月18日に削除され、タグ v2026.9.21 と v2026.9.24 には含まれていません。設定に opencode-free、free、opencode_free が残っていると、削除されたことを知らせるエラーが表示されます。hermes model で opencode-zen(従量課金、OPENCODE_ZEN_API_KEY)または opencode-go(サブスクリプション制、OPENCODE_GO_API_KEY)に切り替えてください。このプロバイダーはv0.20.5の時期に「認証不要のopencode-freeプロバイダー」として追加されました。2353
OpenAI API(直接接続) API キー ~/.hermes/.env に OPENAI_API_KEY を設定します(プロバイダー:openai-api、OPENAI_BASE_URL は任意)26
Google Vertex AI OAuth2 / ADC hermes model → 「Google Vertex AI」(プロバイダー:vertex。サービスアカウントの JSON またはApplication Default Credentials経由の OAuth2を使用し、GCPプロジェクトに課金されます)26
Azure AI Foundry エンドポイント + キー hermes model → 「Azure AI Foundry」(プロバイダー:azure-foundry。Azure OpenAI / Foundryのエンドポイントとキーを使用します。選択メニューでは「OpenAI形式または Anthropic 形式のエンドポイント」と説明されています)26
AWS Bedrock AWS認証情報 hermes model → 「AWS Bedrock」(プロバイダー:bedrock。boto3経由の標準AWS認証情報チェーン、IAM、または API キーを使用します。Claude、Nova、Llama、DeepSeekに対応します)26
NVIDIA NIM / Build API キー ~/.hermes/.env に NVIDIA_API_KEY を設定します(プロバイダー:nvidia。build.nvidia.comでNIMがホストするNemotronなどのモデル、またはベースURLを上書きしてローカルのNIMエンドポイントを利用できます)26
Ollama Cloud OAuth または API キー hermes model → 「Ollama Cloud」(プロバイダー:ollama-cloud。OLLAMA_API_KEY を貼り付け、検出されたクラウドホスト型モデルから選択します)26
StepFun Step Plan APIキー ~/.hermes/.envにSTEPFUN_API_KEYを設定します(プロバイダー:stepfun。Step Plan API経由でエージェント用・コーディング用モデルを利用できます)26
MiniMax(OAuth) OAuth hermes model → 「MiniMax(OAuth)」(プロバイダー:minimax-oauth。Coding Plan向けのブラウザーによるPKCEログインで、グローバルまたは中国リージョンに対応しています)26
Meta AI APIキー ~/.hermes/.envにMODEL_API_KEYを設定します(プロバイダー:meta-ai。Meta Model API、Muse Sparkファミリー)26
NovitaAI APIキー ~/.hermes/.envにNOVITA_API_KEYを設定します(プロバイダー:novita。200以上のモデル、Model API、Agent Sandbox、GPU Cloud)26
Arcee AI APIキー ~/.hermes/.envにARCEEAI_API_KEYを設定します(プロバイダー:arcee。別名:arcee-ai、arceeai。Trinityモデル)26
GMI Cloud APIキー ~/.hermes/.envにGMI_API_KEYを設定します(プロバイダー:gmi。別名:gmi-cloud、gmicloud)。GMIの/v1/modelsエンドポイントが返すモデルIDを正確に指定してください26
Actual Computer APIキーまたはローカルデーモン ホスト型リレーには~/.hermes/.envのACTUAL_API_KEYを、ループバック上でキーなしで動作するローカルデーモンにはACTUAL_BASE_URL=http://127.0.0.1:8080を設定します(プロバイダー:actual。別名:actual-computer、actualcomputer、aci)26
Tencent TokenHub APIキー ~/.hermes/.envにTOKENHUB_API_KEYを設定します(プロバイダー:tencent-tokenhub。別名:tencent、tokenhub、tencentmaas。Hy3 Preview)26
CommandCode APIキー ~/.hermes/.envにCOMMANDCODE_API_KEYを設定します(プロバイダー:commandcode、別名:commandcode-chat。Claudeモデルはcommandcode-anthropic、別名commandcode-claude経由で利用できます)。GOAT/Pro/Max/Providerプランに対応していますが、$1のGoプランにはAPIアクセスがないため利用できません。このプラグインはv0.20.3のリリース時期に追加されました。6826
Alibaba Cloud(Coding Plan) APIキー DASHSCOPE_API_KEY(プロバイダー:alibaba-coding-plan、別名:alibaba_coding)。alibaba DashScopeプロバイダーとは異なるエンドポイントを使う、別の課金SKUです26
Tencent TokenPlan APIキー ~/.hermes/.envにTOKENPLAN_API_KEYを設定します(プロバイダー:tencent-tokenplan、別名:tokenplan、tencent-lkeap。api.lkeap.cloud.tencent.comのAnthropic Messagesエンドポイント経由でHy4プレビューを利用できます)。v0.21.0で追加されました。選択画面では、表示上のみTokenHubとTokenPlanを1つの「Tencent Hy」行にまとめています3536
Nebius Token Factory APIキー ~/.hermes/.envにNEBIUS_API_KEYを設定します(プロバイダー:nebius-token-factory。別名:nebius、nebius-tf、tokenfactory)。v0.21.0で追加されました3536
Ramp Router APIキー ~/.hermes/.envにRAMP_ROUTER_API_KEYを設定します(プロバイダー:router。別名:ramp-router、ramp、router.com)。api.router.comで提供される、OpenAI ResponsesをネイティブにサポートするRampのLLM gatewayで、アカウントごとの最新カタログを利用します。有効なモデルIDは使用中のキーで/v1/modelsから返されるものとなるため、選択画面では固定値を使わず、その都度取得します。v0.21.0で追加されました3536
Alibaba Cloud(Token Plan) APIキー ~/.hermes/.envにALIBABA_TOKEN_PLAN_API_KEYを設定します(プロバイダー:alibaba-token-plan。中国本土向けエンドポイント:alibaba-token-plan-cn)。Model Studioの定額トークンプランで、alibabaとalibaba-coding-planに続く3つ目のAlibaba SKUです36
カスタムエンドポイント config.yaml hermes model → 「Custom endpoint」(config.yamlに保存されます)。ドキュメントのOpenAI互換サービス一覧には、Together AI、Groq、Cerebras(https://api.cerebras.ai/v1)、Mistral、Azure OpenAI、LocalAI、Janが含まれています26
v0.19.0以降では、使わないプロバイダーを除外することもできます。プロバイダーごとのenabled: falseフラグとexcluded_providers設定キーにより、/modelの選択画面や組み込みのプロバイダー解決処理から除外されます。70

Anthropic:3つの認証方法

HermesではClaudeを利用するために3つの異なる方法が用意されており、適切な選択が重要なため、Anthropicについては独立したセクションで説明します。以下は公式ドキュメントからの抜粋です。2

# Method 1: API key (pay-per-token)
export ANTHROPIC_API_KEY=***
hermes chat --provider anthropic --model claude-sonnet-4-6

# Method 2: OAuth through hermes model (preferred)
# Uses Claude Code's credential store when available
hermes model

# Method 3: Manual setup-token (fallback/legacy)
export ANTHROPIC_TOKEN=***
hermes chat --provider anthropic

# Auto-detect Claude Code credentials
hermes chat --provider anthropic   # reads Claude Code files automatically

hermes modelでAnthropic OAuthを選ぶと、Hermesはトークンを~/.hermes/.envにコピーするよりも、Claude Code独自の認証情報ストアを優先して利用します。これにより、更新可能なClaudeの認証情報を、引き続き更新できる状態で維持できます。2 同じマシンですでにClaude Codeを使っている場合は、この方法が最もシンプルです。

config.yamlでAnthropicを常に使用するよう固定するには、次のように設定します。

model:
  provider: "anthropic"
  default: "claude-sonnet-4-6"

--provider claudeと--provider claude-codeも、--provider anthropicの短縮形として使えます。2

GitHub Copilot:2つのモード

Copilotには、Copilot APIを直接利用するモード(推奨)と、ローカルのCopilot CLIをサブプロセスとして起動するCopilot ACPモードの2つがあります。2 v0.22.6のリリース時期以降、両モードはコアではなくgithub-copilotプラグイン(コミュニティ区分、NousResearch/hermes-labs-plugins)として提供されます。hermes plugins install github-copilotで追加でき、hermes updateはcopilotまたはcopilot-acp経由で接続済みのすべてのprofileにこのプラグインをインストールします。以下のコマンド、設定キー、環境変数は変わりません。67

# Direct Copilot API
hermes chat --provider copilot --model gpt-5.4

# Copilot ACP (requires the Copilot CLI in PATH + an existing copilot login)
hermes chat --provider copilot-acp --model copilot-acp

公式ドキュメントによると、認証情報は次の順序で確認されます。2 1. COPILOT_GITHUB_TOKEN環境変数 2. GH_TOKEN環境変数 3. GITHUB_TOKEN環境変数 4. gh auth token CLIへのフォールバック 5. hermes model経由のOAuthデバイスコードログイン

トークンの種類が重要です。 Copilot APIは従来型のPersonal Access Token(ghp_*)に対応していません。対応しているのは、OAuthトークン(gho_*)、きめ細かな権限を設定できるPAT(Copilot Requests権限を持つgithub_pat_*)、GitHub Appトークン(ghu_*)です。gh auth tokenがghp_*トークンを返す場合は、代わりにhermes modelでOAuth認証を行ってください。2

中国のAIプロバイダー(標準で対応)

Hermesは、z.ai/GLM、Kimi/Moonshot、MiniMax(グローバルおよび中国向けエンドポイント)、Alibaba Cloudに専用のプロバイダーIDで標準対応しています。2

# z.ai / ZhipuAI GLM
hermes chat --provider zai --model glm-5                 # Requires: GLM_API_KEY

# Kimi / Moonshot AI
hermes chat --provider kimi-coding --model kimi-for-coding   # Requires: KIMI_API_KEY

# MiniMax (global)
hermes chat --provider minimax --model MiniMax-M2.7          # Requires: MINIMAX_API_KEY

# MiniMax (China)
hermes chat --provider minimax-cn --model MiniMax-M2.7       # Requires: MINIMAX_CN_API_KEY

# Alibaba Cloud / DashScope (Qwen)
hermes chat --provider alibaba --model qwen3.5-plus          # Requires: DASHSCOPE_API_KEY

ベースURLは、GLM_BASE_URL、KIMI_BASE_URL、MINIMAX_BASE_URL、MINIMAX_CN_BASE_URL、DASHSCOPE_BASE_URLの各環境変数で上書きできます。2

Z.AIではエンドポイントが自動検出されます。 z.ai/GLMプロバイダーを使うと、Hermesは複数のエンドポイント(グローバル、中国、コーディング用)を試し、使用中のAPIキーを受け付けるものを探します。利用可能なエンドポイントは自動的にキャッシュされるため、ほとんどの場合、GLM_BASE_URLの設定は不要です。2

xAI(Grok)ではプロンプトキャッシュが自動で有効になります。 ベースURLにx.aiが含まれている場合、Hermesはすべてのリクエストにx-grok-conv-idヘッダーを付けます。これにより、同じ会話セッション内のリクエストが同じサーバーに送られ、キャッシュ済みのシステムプロンプトと履歴を再利用できます。2 自動で動作するため、設定は不要です。

hermes authコマンド

hermes authは、認証情報プールとOAuth認証情報を管理するコマンドです。6

hermes auth                              # Interactive wizard
hermes auth list                         # Show all credential pools
hermes auth list openrouter              # Show one provider's pool
hermes auth add openrouter --api-key sk-or-v1-xxx
hermes auth add anthropic --type oauth
hermes auth remove openrouter 2          # Remove by index
hermes auth reset openrouter             # Clear cooldowns

認証情報プールを使うと、同じプロバイダーの複数のAPIキーやOAuthトークンを順番に切り替えて利用できます。コードを変更せずに、複数のキーに利用を分散してレート制限に対処したい場合に便利です。6 旧来のhermes login / hermes logoutコマンドは削除されています。代わりにhermes authを使ってください。6

カスタムエンドポイントとセルフホスト型エンドポイント

Hermesは、OpenAI互換のAPIエンドポイントであれば利用できます。サーバーが/v1/chat/completionsを実装していれば、Hermesの接続先として指定できます。2

対話形式のセットアップ(推奨):

hermes model
# Select "Custom endpoint (self-hosted / VLLM / etc.)"
# Enter: API base URL, API key, Model name

config.yamlを手動で設定する場合:

model:
  default: your-model-name
  provider: custom
  base_url: http://localhost:8000/v1
  api_key: your-key-or-leave-empty-for-local

どちらの方法でも設定は config.yaml に保存されます。このファイルが、メインモデル、プロバイダー、ベースURLの唯一の正となります。2 従来の環境変数 OPENAI_BASE_URL と LLM_MODEL は、メインモデルの設定には読み込まれなくなりました。hermes model を使うか、config.yaml を直接編集してください。2(ただし、OPENAI_BASE_URL + OPENAI_API_KEY は、補助的な provider: "main" ルーティング経路のフォールバックとして引き続き使用されるため、そこで使っている場合は不用意に削除しないでください。)4

セッション中にカスタムエンドポイントを切り替える:

/model custom:qwen-2.5             # Custom endpoint with explicit model
/model custom                      # Auto-detect the model from the endpoint
/model custom:local:qwen-2.5       # Named custom provider "local"
/model custom:work:llama3          # Named custom provider "work"
/model openrouter:claude-sonnet-4  # Back to a cloud provider

/model custom(モデル名を付けずに実行)は、エンドポイントの /v1/models API に問い合わせ、読み込まれているモデルが1つだけなら自動で選択します。単一モデルを実行するローカルサーバーで便利です。2

ローカル LLM サーバー(セットアップテンプレート)

公式ドキュメントには、Ollama、vLLM、SGLang、llama.cpp、LM Studioの詳しいセットアップガイドがあります。ここでは、実際に使う主要なコマンドを紹介します。いずれも、Hermesから接続できるエンドポイントを構築するためのものです。2

v0.22.0以降では、Hermes自体でモデルを実行できます。 hermes model → ローカルモデル(デスクトップアプリでは設定 ▸ プロバイダー ▸ ローカルモデル)から、ハードウェアに合ったllama.cppビルドをインストールし、管理できます(CPU、CUDA、Metal、Vulkan、ROCmに対応。v0.22.0のロックファイルでは b11370)。カタログ内の各モデルを GPU とRAMの容量に照らして評価し、容量に収まる最高品質のビルドをダウンロードします。一時停止と再開にも対応しています。カタログにはQwen3.8 27B、Qwen3.8 Flash Next、Qwen3.6 35B-A3B、DeepSeek V4 Flashがあり、Hugging Faceの任意のGGUFも利用できます。サーバーはHermesとともに起動・停止し、GPU メモリに完全に収まるモデルだけが推奨されます。自分でサーバーを実行する場合は、引き続き以下のテンプレートを使います。5859 v0.22.2では、ノートPC上での長時間にわたるローカル処理の安定性が向上しています。ステータス行へのプロンプト読み込み状況の表示、スリープ時間を除外する停止検知タイマー、サーバー復旧時にサーキットブレーカーで遮断せず再試行する処理、長い会話を読み込み中のサーバーを待つ圧縮期限の処理、Windowsのユニファイドメモリ搭載機でメモリ容量に合わせて起動する処理が追加されています。62

Ollama — 設定不要で、最も手軽にローカル実行できます:

ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=32768 ollama serve   # Raise from 4k default
hermes model   # Custom endpoint → http://localhost:11434/v1 → qwen2.5-coder:32b

Ollamaの重要な注意点: Ollamaのデフォルトのコンテキスト長は非常に短く設定されています(VRAMが24GB未満の場合は4,096トークン)。OLLAMA_CONTEXT_LENGTH またはModelfileで必ず引き上げてください。OpenAI互換の API はクライアントからのコンテキスト長指定を受け付けないため、Hermes側では設定できません。2 エージェント用途では、少なくとも16k〜32kに設定してください。

vLLM — GPU による高性能な推論サーバーです:

pip install vllm
vllm serve meta-llama/Llama-3.1-70B-Instruct \
  --port 8000 \
  --max-model-len 65536 \
  --tensor-parallel-size 2 \
  --enable-auto-tool-choice \
  --tool-call-parser hermes

ツール呼び出しには --enable-auto-tool-choice と --tool-call-parser <name> が必要です。対応パーサーは hermes(Qwen 2.5、Hermes 2/3)、llama3_json、mistral、deepseek_v3、deepseek_v31、xlam、pythonic です。これらのフラグがないと、ツール呼び出しがプレーンテキストとして返されます。2

SGLang — RadixAttentionでKVキャッシュを再利用し、高速に推論を提供します:

pip install "sglang[all]"
python -m sglang.launch_server \
  --model meta-llama/Llama-3.1-70B-Instruct \
  --port 30000 \
  --context-length 65536 \
  --tp 2 \
  --tool-call-parser qwen

SGLangの注意点: max_tokens のデフォルト値は128です。応答が途中で切れる場合は、サーバー側で --default-max-tokens を設定するか、config.yaml の model.max_tokens を設定してください。2

llama.cpp / llama-server — CPUとApple SiliconのMetalに対応しています:

./build/bin/llama-server \
  --jinja -fa \
  -c 32768 \
  -ngl 99 \
  -m models/qwen2.5-coder-32b-instruct-Q4_K_M.gguf \
  --port 8080 --host 0.0.0.0

ツール呼び出しには --jinja が必須です。 これがないと、llama-serverは tools パラメーターを完全に無視し、モデルは応答テキストに JSON を書き込むことでツールを呼び出そうとします。Hermesはこれを実際のツール呼び出しとして解析できません。2

LM Studio — GUIを備えたデスクトップアプリです:

LM Studioアプリからサーバーを起動するか(Developerタブ → Start Server)、CLI で lms server start(ポート1234で起動)と lms load qwen2.5-coder --context-length 32768 を実行します。2 続いて、hermes model の接続先を http://localhost:1234/v1 に設定してください。

LM Studioの重要な注意点: LM Studioはモデルのメタデータからコンテキスト長を読み取りますが、多くのGGUFモデルではデフォルト値が2048または4096になっています。LM Studioのモデル設定で、必ずコンテキスト長を明示的に設定してください。モデル選択欄の横にある歯車アイコンをクリックし、「Context Length」を少なくとも16384(推奨は32768)に設定して、モデルを再読み込みします。2

名前付きカスタムプロバイダー

複数のカスタムエンドポイント(たとえば、ローカルの開発サーバーとリモートの GPU サーバー)を使う場合は、config.yaml に名前付きカスタムプロバイダーとして定義します。2

custom_providers:
  - name: local
    base_url: http://localhost:8080/v1
    # api_key omitted — Hermes uses "no-key-required" for keyless local servers
  - name: work
    base_url: https://gpu-server.internal.corp/v1
    api_key: corp-api-key
    api_mode: chat_completions      # optional, auto-detected from URL
  - name: anthropic-proxy
    base_url: https://proxy.example.com/anthropic
    api_key: proxy-key
    api_mode: anthropic_messages    # for Anthropic-compatible proxies

その後、3要素の構文を使ってセッション中に切り替えられます:

/model custom:local:qwen-2.5
/model custom:work:llama3-70b
/model custom:anthropic-proxy:claude-sonnet-4

対話式の hermes model メニューからも、名前付きカスタムプロバイダーを選択できます。2

プラグインで拡張できるプロバイダーアーキテクチャ(v0.13.0以降)

v0.13.0には、ProviderProfile 抽象基底クラス(ABC)と plugins/model-providers/ ディレクトリが導入されています。これにより、コアを変更せずにサードパーティーの推論プロバイダーを追加できます。18 プロバイダーがOpenAI、Anthropic、Codexのいずれかと互換性のある API モードに対応していれば、認証経路、ベースURL、モデルカタログ、キャッシュ用ヘッダーを宣言する ProviderProfile サブクラスを実装できます。Hermesは組み込みプロバイダーと同じ runtime_provider.py の経路でこれを解決します。これが、v0.13.0でプロバイダーが拡充された背景にあるアーキテクチャの変更です。プロバイダーを追加するためにコアコードを編集するのではなく、プラグインとして提供できるようになりました。

OpenAI互換のローカルプロキシ(v0.14.0以降)

hermes proxy は、Hermesですでにサインインしている OAuth プロバイダー(Claude Pro、ChatGPT Pro、SuperGrok、または設定済みの別の互換プロバイダー)を利用する、OpenAI互換のローカルエンドポイントを提供します。19 つまり、Codex CLI、Aider、Cline、Continue、独自のスクリプトなど、OpenAI形式の API を想定したツールで、別途 API キーを用意せずに、サブスクリプションに紐づくHermesの認証を再利用できます。このプロキシはローカルの開発用インフラとして扱ってください。バインド先を意図的に指定し、広範囲に公開せず、各プロバイダーの利用規約にも留意しましょう。

コンテキスト長の検出

公式ドキュメントによると、次の2つの設定はよく混同されます。2

  • context_length — コンテキストウィンドウ全体のサイズです(入力と出力を合計したトークン枠。たとえば Claude Opus 4.7では1,000,000、Sonnet 4.6では200,000)。Hermesはこの値を使って履歴を圧縮するタイミングを判断します。
  • model.max_tokens — 出力の上限です(モデルが1回の応答で生成できる最大トークン数)。履歴の長さとは関係ありません。

自動検出でウィンドウサイズが正しく取得されない場合は、context_length を設定してください:

model:
  default: "qwen3.5:9b"
  base_url: "http://localhost:8080/v1"
  context_length: 131072      # tokens

Hermesは複数の情報源を順に参照して、コンテキストウィンドウを検出します。設定による上書き → カスタムプロバイダーのモデル別設定 → 永続キャッシュ → エンドポイントの /models → Anthropic の /v1/models → OpenRouter API → Nous Portal → models.dev(コミュニティが管理する3,800以上のモデルのレジストリ)→ フォールバックのデフォルト値(128K)の順です。2 この仕組みはプロバイダーの違いを考慮するため、同じモデルでも提供元によってコンテキスト上限が異なる場合があります(たとえば、claude-opus-4.6 は Anthropic の直接提供では1Mですが、GitHub Copilotでは128Kです)。2

スマートモデルルーティング:プロバイダーのローテーションとフォールバック

Hermesでは、1つのプロバイダーの1つのモデルに縛られることはありません。スマートモデルルーティングとは、 個々のリクエストを実際に処理するプロバイダーとモデルを決める仕組みの総称です。認証情報プールで 複数のキーに負荷を分散し、プライマリーが失敗した際は設定済みのフォールバックが引き継ぎます。 さらに、後述の補助スロットでは、メインモデルとは独立して補助タスクを低コストの モデルに振り分けます。26 この3つを組み合わせて設定してください。レート制限でエージェントが 停止するか、そのまま動き続けられるかを左右する設定です。

認証情報プール。 同じプロバイダーの API キーを複数持っている場合は、hermes auth でローテーション方式を設定します。これにより、複数のキーにリクエストを分散し、それぞれのレート制限枠を活用できます。6 フォールバックモデル。 メインモデルで障害(レート制限、サーバーエラー、認証失敗)が発生した際に、Hermesが自動で切り替える予備のprovider:modelを設定します。2

fallback_model:
  provider: openrouter            # required
  model: anthropic/claude-sonnet-4  # required
  # base_url: http://localhost:8000/v1    # optional, for custom endpoints
  # api_key_env: MY_CUSTOM_KEY           # optional, env var name

フォールバックでは、会話を維持したままセッションの途中でモデルとプロバイダーを切り替えます。発動するのは1セッションにつき最大1回です。2 フォールバックで利用できるプロバイダーは、openrouter、nous、openai-codex、copilot、copilot-acp、anthropic、huggingface、zai、kimi-coding、minimax、minimax-cn、deepseek、ai-gateway、opencode-zen、opencode-go、kilocode、alibaba、customです。2

補助モデル

Hermesは、画像分析(ビジョン)、危険なコマンドの承認要否の分類、コンテキスト圧縮、セッションタイトル生成、TTS音声タグ挿入、skillの照合、MCPツールの振り分け、Kanbanの仕様策定・タスク分解モデル群といった付随タスクに「補助」モデルを使用します。v0.21.6以降は音声ターンにも使用します(auxiliary.voice_chatは、デフォルトでreasoning_effort: noneを指定した高速なモデルで音声ターンを処理します。ただし、リクエストが音声モデルの圧縮しきい値に収まらない場合は、メインモデルを引き続き使用します)。43455 デフォルト(auxiliary.*.provider: "auto")では、すべての補助タスクがメインのチャットモデルで実行されます。つまり、hermes modelで選んだものと同じプロバイダーとモデルです。ドキュメントには、これが以前の低コストプロバイダーの自動検出に代わる動作であると明記されています。「以前のビルドでは、アグリゲーター(OpenRouter、Nous Portal)のユーザーには、プロバイダー側の低コストなデフォルトモデルを別途割り当てていました。これは予想外の動作でした……現在、autoはすべてのユーザーでメインモデルを使用し、config.yamlのタスク別設定が引き続き優先されます」。34 使い始めるための設定は不要ですが、その分コストには注意が必要です。高価な推論モデルでは補助タスクも無視できない費用になるため、コストを重視する場合は、個々のタスクに安価で高速なモデルを指定してください。

以前は補助モデルを使っていた2つのタスクは、現在ではLLMを一切使用しません。ウェブ抽出(「web_extractとブラウザーのスナップショットは、長いコンテンツを決まったルールで切り詰め、read_fileでページ単位に読み出せるよう全文を保存します。LLMは関与しません」)と、セッション検索(単一形式のツールがDBの内容を直接返します)です。以前のauxiliary.web_extract.*とauxiliary.session_search.*のブロックはデフォルト設定から削除されています。既存のconfig.yamlに残っている値は「無害な残存設定として無視されます」。また、当該タグのデフォルト設定にはflush_memoriesのスロットもありません。34

補助タスクごとに、使用するモデルとプロバイダーを設定できます。 すべての補助スロットで共通の設定項目を使用します。provider、model、base_urlに加え、api_key、timeout、extra_body、タスク別のreasoning_effortを指定できます。434

auxiliary:
  vision:                          # vision_analyze + browser screenshots
    provider: "auto"               # "auto" (= main model), "openrouter", "nous", "main", etc.
    model: ""                      # e.g. "openai/gpt-4o", "google/gemini-2.5-flash"
    base_url: ""                   # Custom OpenAI-compatible endpoint
    api_key: ""                    # Falls back to OPENAI_API_KEY
    timeout: 120
    download_timeout: 30
  approval:                        # dangerous-command approval classifier
    provider: "auto"
    model: ""
    timeout: 30
  compression:                     # summarizer -- legacy compression.summary_* keys migrate here (config v17)
    provider: "auto"
    model: ""
    base_url: ""
    timeout: 120
  title_generation:                # auto-generated session titles after the first exchange
    enabled: true                  # set false to disable auto-titles
    provider: "auto"
    model: ""
    language: ""                   # empty follows the conversation; e.g. "English" pins titles to one language
  tts_audio_tags:    { provider: "auto", model: "" }  # Gemini 3.1 TTS hidden audio-tag insertion
  skills_hub:        { provider: "auto", model: "" }  # skill matching and search
  mcp:               { provider: "auto", model: "" }  # MCP tool dispatch
  triage_specifier:  { provider: "auto", model: "" }  # hermes kanban specify: rough one-liner into a concrete spec, promoted to todo
  kanban_decomposer: { provider: "auto", model: "" }  # hermes kanban decompose: triage task into a graph of child tasks routed to specialist profiles
  profile_describer: { provider: "auto", model: "" }  # hermes profile describe --auto: 1-2 sentence profile descriptions

より専門的なスロットも同じ形式です。goal_judge(/goalの契約条件が満たされたかを判定)、curator(skillの使用状況をレビューする分岐)、background_review(ターン後に自己改善を行う分岐)、review(/reviewのレビュー担当サブエージェント)、moa_referenceとmoa_aggregator(Mixture-of-Agents)、memory_query_rewrite、monitorがあります。YAMLを手作業で編集する必要はありません。hermes modelを実行し、「Configure auxiliary models」を選ぶと、タスクごとに対話形式で選択できます。34

プロバイダーの選択肢である"main"は、「メインエージェントと同じプロバイダーを使う」という意味です。使用できるのは、auxiliary:、compression:、メインモデルのフォールバック設定(fallback_providers:、または旧形式のfallback_model:)内のみです。最上位のmodel.provider設定では使用できません。メインモデルにカスタムのOpenAI互換エンドポイントを使う場合は、model:セクションにprovider: customを設定してください。4

これが重要な理由: autoは最初からメインモデルを使うため、以前の「OpenRouterを設定しないと補助タスクの品質が知らないうちに低下する」という落とし穴はなくなりました。現在の検討事項はコストです。メインモデルが高価な推論モデルの場合は、頻繁に呼び出される付随タスクを安価で高速なモデルに振り分けましょう。

auxiliary:
  vision:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"
  compression:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"

設定システム

Hermesの設定システムは階層構造になっています。上位の階層が下位の階層を上書きするため、優先順位の理解が欠かせません。さらに、その階層の1つは、config.yamlには表示されないグローバルなプロバイダーレジストリです。

設定ファイルの構成

公式ドキュメントによると、Hermesの設定は次のファイルで構成されます。4

~/.hermes/
├── config.yaml       # All settings (model, terminal, TTS, compression, memory, toolsets, ...)
├── .env              # Secrets (API keys, bot tokens, passwords)
├── auth.json         # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md           # Primary agent identity (slot #1 in system prompt)
├── memories/         # Persistent memory (MEMORY.md, USER.md)
├── skills/           # Bundled + agent-created + hub-installed skills
├── cron/             # Scheduled jobs
├── sessions/         # Gateway session state
└── logs/             # agent.log, gateway.log, errors.log (secrets auto-redacted)

config.yamlと.envの両方に設定がある場合、機密情報以外の設定ではconfig.yamlが優先されます。4 使い分けのルールは次のとおりです。 - 機密情報(APIキー、ボットトークン、パスワード)→ .env - それ以外のすべて(モデル、ターミナルのバックエンド、圧縮設定、メモリの上限、toolset)→ config.yaml

シェル形式の変数展開を使えば、config.yamlから機密情報を参照できます。4

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}
  delegation:
    api_key: ${DELEGATION_KEY}

設定の管理

hermes config                # View current configuration
hermes config show           # Same as above
hermes config edit           # Open config.yaml in your editor
hermes config set KEY VAL    # Set a specific value
hermes config get KEY        # Print a single value (v0.19.0+)
hermes config unset KEY      # Remove a key so the default applies again (v0.19.0+)
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

例:4

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...   # Saves to .env

hermes updateを実行した後は、毎回hermes config checkとhermes config migrateを実行しましょう。新たに追加された設定項目のうち、手元のファイルにまだ含まれていないものを検出できます。6

設定の優先順位

Hermesは複数のソースから設定を読み込みます。同じ値が複数のソースで設定されている場合は、優先順位の高いソースが適用されます。4

  1. CLI引数 — hermes chat --model anthropic/claude-sonnet-4(その実行に限って上書きします)
  2. 環境変数 — プロセスの起動時に適用されます
  3. config.yaml — 主となる設定ファイルです
  4. .env — 機密情報のみを設定します
  5. 組み込みの既定値 — ほかで値が設定されていない場合に適用されます

CLIフラグは、その実行に限り常に最優先されます。継続的に使う設定の基準となるのはconfig.yamlです。

ローカライズ(v0.13.0以降)

v0.13.0では、CLIとgatewayのメッセージに、中国語(簡体字)、日本語、ドイツ語、スペイン語、フランス語、ウクライナ語、トルコ語の7つのロケールが追加されました。18 v0.14.0では、gatewayの全コマンドとWebダッシュボードがローカライズされ、さらに8つのロケールが追加されて、合計16となりました。19 タグv2026.8.31時点のlocales/ツリーには、英語と16言語の翻訳(af、ar、de、es、fr、ga、hu、it、ja、ko、pt、ru、tr、uk、zh-hant、zh)からなる17のメッセージカタログが含まれています。33 ドキュメントの翻訳は、現在zh-Hansのみです。ロケールは環境変数LC_ALL / LANG、またはconfig.yamlで明示的に指定したlocale:キーから決まります。既定の言語は引き続き英語で、未翻訳の文字列についても英語が基準となります。v0.21.6では言語をプラグインで追加できるようになりました。 display.languageには、同梱の17のカタログ、profileのオーバーレイディレクトリ、またはインストール済みプラグインの言語パックが提供する任意のIDを指定できます。hermes config set display.language <id>は最初にプラグインを検出するため、インストールしたばかりの言語パックも認識されます。コアとTUIの文字列は別の階層に分かれています(locales/<lang>.yamlとlocales/<lang>.tui.yaml。このタグではTUI用パックは16個です)。55

profile — 分離された複数のHermesインスタンス

profileを使うと、それぞれが独自の設定、セッション、skill、メモリ、gatewayのPIDを持つ、分離された複数のHermesインスタンスを利用できます。これにより、「仕事用Hermes」と「個人用Hermes」を、互いの状態が見えないまま並行して実行できます。6

v0.22.0以降は、マシンごとに1つのメッセージングgatewayと1つのデスクトップバックエンドが、すべてのprofileを処理します。競合がなければ、hermes updateは既存のprofileごとのgatewayを、この標準構成に統合します。統合できない理由はhermes gateway statusで確認でき、手動で移行するにはhermes gateway migrate --multiplexを使います。gateway.standalone: trueで一時的に統合を回避できますが、ソースコードでは互換性維持のための暫定措置とされており、サポート対象の構成ではありません。5859 v0.22.2では、再利用されたPIDを稼働中のgatewayと誤認し、監視下のgateway(systemd、launchd、Docker)が再起動後に起動を拒否する問題が修正されました。Hermesは起動時のブート情報を記録するようになり、判別できない場合はホストのロックに判断を委ねます。62

hermes profile list
hermes profile create work --clone                  # Clone from current profile
hermes profile use work                             # Set sticky default
hermes profile alias work --name h-work             # Create wrapper script
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"    # One-off without switching

各profileには専用のHERMES_HOME(既定では~/.hermes-<name>/)が割り当てられるため、複数のprofileで互いに干渉せずにgatewayを同時実行できます。63

v0.21.2では、分離境界がより厳密に適用されるようになりました。gatewayを多重化した構成で実際に発生していたprofile間の漏洩が、一連の修正で解消されています。具体的には、追加のprofileが既定のprofileの許可リストを引き継ぐ、そのホストに認証情報を送信する、その保管庫の機密情報をstdio MCPサーバーに渡す、別のprofileの.env/auth.json/state.dbをMEDIA:配信に添付するといった問題です(#107609-#107630)。profileを多重化している場合、分離が実際に保証されるようになったタグはv0.21.2です。v0.21.2の新機能をご覧ください。48


CLIコマンド

このセクションは、トップレベルのCLIコマンドを実務で使うためのリファレンスです。コードに基づく公式のリファレンスは、上流のCLIコマンドリファレンスをご覧ください。6

グローバルオプション

hermes [global-options] <command> [subcommand/options]
オプション 説明
--version, -V バージョンを表示して終了します
--profile <name>, -p <name> 使用するHermesのprofileを選択します
--resume <session>, -r <session> IDまたはタイトルでセッションを再開します
--continue [name], -c [name] 最新のセッション(またはタイトルが一致するセッション)を再開します
--worktree, -w 分離されたgit worktreeで起動します
--in <dir> 起動または再開の前にDIRへ移動します。--resume latestまたは-cと組み合わせると、DIRのワークスペースで最新のセッションを選び、そのままDIRで続行します(記録済みの作業ディレクトリへの復元をスキップします)27
--ignore-user-config ~/.hermes/config.yamlを無視し、組み込みの既定値を使用します(.envの認証情報は引き続き読み込まれます)27
--ignore-rules AGENTS.md、SOUL.md、.cursorrules、メモリ、事前読み込みするskillの自動挿入をスキップします27
--tui 従来のREPLに代わり、新しいTUIを起動します27
--cli 従来のprompt_toolkit REPLを強制的に使用します(display.interface=tuiより優先されます)27
--dev --tuiと併用すると、tsxでTypeScriptのソースを実行します(distのビルドをスキップします)27
--yolo 危険なコマンドの承認プロンプトを省略します
--safe-mode トラブルシューティング用のフラグです。起動時の問題を切り分けるため、最小構成のセーフモードでHermesを起動します(v0.19.0以降)70
--pass-session-id エージェントのシステムプロンプトにセッションIDを含めます

トップレベルコマンド

コマンド 用途
hermes chat 対話形式または単発のチャットを実行します
hermes model 既定のプロバイダーとモデルを対話形式で選択します
hermes gateway メッセージングgatewayを実行・管理します
hermes setup 対話形式のセットアップウィザードを起動します
hermes auth 認証情報を管理します。追加、一覧表示、削除、リセット、戦略の設定ができます
hermes status エージェント、認証、プラットフォームの状態を表示します。v0.21.6以降は既定で1画面の概要を表示し、--full(または--all)で全セクション、--deepで時間のかかるチェックを実行します
hermes cron cronスケジューラーを確認し、スケジュールの実行判定を進めます。hermes cron cancelは進行中の実行を停止します(v0.22.6のリリース時期)67
hermes webhook 動的なWebhookサブスクリプションを管理します
hermes doctor 設定や依存関係の問題を診断します
hermes dump サポートやデバッグ用に、コピーして貼り付けられるセットアップの概要を出力します
hermes logs エージェント、gateway、エラーのログを表示、追跡、絞り込みできます
hermes config 設定を表示、編集、移行、照会します
hermes pairing メッセージングのペアリングコードを承認・取り消しします
hermes skills skillを閲覧、インストール、公開、監査します
hermes honcho Honchoのセッション間メモリを管理します。プラグインに依存するコマンドです。ドキュメントには「プラグイン固有のサブコマンド(例:hermes honcho)は、そのプロバイダーが有効なときに自動登録されます」とあり、Honchoが有効なメモリプロバイダーでなければhermes --helpに表示されません6
hermes memory 外部メモリプロバイダーを設定します
hermes acp HermesをACPサーバーとして実行します(エディター連携)
hermes mcp MCPサーバーの設定を管理し、HermesをMCPサーバーとして実行します。v0.22.5のリリース時期以降、Hermes自体をMCPサーバーとして実行する機能はmcp-serveプラグインが担います(hermes plugins install mcp-serveの後にhermes mcp-serveを実行し、MCPクライアントの引数を["mcp-serve"]に変更します)65
hermes plugins プラグインを管理します。hermes plugins updateは、利用可能なすべてのプラグイン更新を提示します(v0.22.3のリリース時期)64
hermes tools プラットフォームごとに有効なツールを設定します
hermes sessions セッションを閲覧、エクスポート、整理、削除します。v0.19.0ではhermes sessions exportがMarkdown、Quarto、HTML、プロンプトのみ、Hugging Faceトレースの各形式に対応し、任意で指定する--redactによるシークレット除去処理と、経過時間・ワークスペース・プラットフォームのフィルターが追加されました70。hermes sessions recoverは、破損したstate.dbから正規のセッションデータを別の新規データベースへ再構築します。オフラインで非破壊的に動作し、--inspect-onlyではデータベースを作成せず、正規テーブルの読み取り可否を報告します(v0.21.2で案内されている復旧手段)48。hermes sessions set-journal-mode delete\|wal(v0.21.4のリリース時期)は、ストアをオフラインでWALとロールバックジャーナルの間で変換します。他のプロセスがデータベースまたはサイドカーファイルを保持している間は実行を拒否し、それらの解放を待たずに切り替えます。切り替え後にはSQLiteヘッダーの18・19バイト目を検証し、既定以外のストアには--dbを指定できます。まずgateway、ダッシュボード、すべてのCLIを停止してください。保持プロセスを走査しないWindowsでは、すべてのHermesプロセスを自分で停止したうえで--forceを渡すまで実行を拒否します。コマンド自身が変換対象のストアを開かないよう、処理の呼び出しは意図的にオフラインで行われます。現在はhermes doctorからもこのコマンドが案内されます51
hermes insights トークン、コスト、アクティビティの分析を表示します
hermes usage セッションを開始せずに、設定済みアカウントのレート制限の時間枠(/usageブロック)を表示します。スクリプト向けには--jsonを使用できます(v0.22.0)59
hermes claw OpenClawからの移行を支援します。v0.22.5のリリース時期にコアからagent-importersプラグインへ移動しました。hermes claw migrateというコマンド表記は維持され、hermes claw cleanupが追加されています65
hermes profile profile(複数の分離されたインスタンス)を管理します
hermes completion シェル補完スクリプト(bash/zsh)を出力します
hermes whatsapp WhatsAppブリッジの設定とペアリングを行います
hermes --version (-V) バージョン情報を出力します。サブコマンドではなくグローバルフラグです。タグv2026.8.31では、_BUILTIN_SUBCOMMANDS集合にversionのエントリーはなく、起動時の高速処理経路が認識するのは--version / -Vのみです27
hermes update ソースからのインストールを更新し、依存関係を再インストールします。v0.21.7以降、公式のチェックアウトは最新の公開リリースに追従します(すべてのコミットに追従するには--set-channel main、今回だけチャネルを指定するには--channel <name>、このインストールのIDを表示するには--install-idを使います)
hermes pm すべての管理対象インストールを支える統合パッケージマネージャーです(v0.22.0)。doctorはインストール状態をロックファイルと照合し、statusは最新の同期記録を出力し、repairは依存関係の環境を再構築し、gcは参照されていないストア項目を削除します59。v0.22.6のリリース時期以降は、中断したダウンロードを再開できます(リリースノートの記載)66
hermes uninstall システムからHermesを削除します(--fullでは設定とデータも削除します)
hermes backup 設定、セッション、skill、メモリを完全にバックアップします(v0.9.0以降)16
hermes import バックアップアーカイブから復元します。マシン間の移行やロールバックに使えます(v0.9.0以降)16
hermes dashboard ブラウザーでエージェントを管理するためのローカルWebダッシュボードを起動します(v0.9.0以降)16
hermes webapp Hermes Desktopのワークスペースをブラウザーで開きます。webapp.enabledがtrueのときにgatewayが配信し、必要に応じてビルドし、1回限りのサインインリンクから開きます。--no-open、--status、--build-onlyがあります(v0.22.6のリリース時期)67
hermes vault ローカルの認証情報保管庫です。hermes vault keyは保管庫のキーの保存場所を表示し、hermes vault key migrate --to keychain(または--to file)でvault.keyとOSのキーチェーンの間を移動します(vault.key_storage、v0.22.6のリリース時期)67
hermes serve バックエンドのAPIサーバーをヘッドレスで実行します。v0.19.0以降、Web UIのビルドやマウントは行いません70
hermes debug share トラブルシューティング時に共有できるよう、完全なデバッグレポートをpastebinにアップロードします(v0.9.0以降)16
hermes approvals 承認プロンプト用のツールです。suggestは承認履歴を分析してcommand_allowlistの候補を提案します。testはコマンドを実行せずに承認判定を試します(「実行は一切しません」。--backendと--jsonに対応しています)。v0.21.0のリリースノートでは、この試行機能をhermes approval-checkとして紹介していますが、タグv2026.8.31にapproval-checkサブコマンドは存在しません。実際のコマンドはhermes approvals testです2740
hermes bundles skillバンドルを作成、一覧表示、管理します(1つの/<name>スラッシュコマンドで複数のskillを呼び出すエイリアスです)27
hermes checkpoints /rollbackを支えるシャドウストア~/.hermes/checkpoints/を確認、整理、消去します。引数なしで実行すると状態の概要を表示します27
hermes computer-use Computer Use(cua-driver)バックエンドを管理します(macOS/Windows/Linux)27
hermes console 安全なHermesコマンドコンソールを開きます27
hermes curator skillのバックグラウンドメンテナンス(curator)を管理します。状態確認、実行、一時停止、固定ができます27。v0.22.6のリリース時期以降はlockとunlockも使えます(ロックしたskillはエージェントが変更できません)67
hermes egress リモートターミナルのサンドボックス向けに、外向き通信へ認証情報を挿入するiron-proxyファイアウォールを管理します(既定では無効です)27
hermes fallback プライマリモデルが失敗したときに試すフォールバックプロバイダーを管理します27
hermes hooks シェルスクリプトのフックを確認・管理します。list、test <event>、revoke、doctorを使用できます(実行ビット、許可リスト、mtimeの変化、JSONの妥当性、模擬実行の所要時間を確認します)27
hermes import-agent Claude Code(~/.claude)またはCodex CLI(~/.codex)の設定をHermesにインポートします27。v0.22.5のリリース時期以降はagent-importersプラグインに移り、Cursor(~/.cursor)とOpenClawにも対応しています。必ず最初にプレビューを表示し、適用前に確認します。--syncで変更された移行元を再インポートできます。hermes setupは別のエージェントを検出すると、このプラグインのインストールを提案します65
hermes desktop(エイリアス:gui) ネイティブのElectronデスクトップアプリをビルドして起動します27
hermes kanban 複数のprofileで共同作業するためのボードです(タスク、リンク、コメント)。ボード、swarmグラフ(swarm:並列ワーカー → 検証役 → 統合役)、ディスパッチャーを備えています27
hermes login / hermes logout 非推奨です。認証情報の管理にはhermes auth、プロバイダーの選択にはhermes model、全体のセットアップにはhermes setupを使用してください27
hermes lsp Language Server Protocolを管理します。status、list、install <server>、install-all、restartを使用できます(restartは実行中のLSPクライアントを終了し、次の編集時に再起動させます)27
hermes migrate 提供終了したモデルや非推奨の設定に対応するため、設定を移行します27。v0.22.6のリリース時期以降、hermes migrate <agent>はagent-importersプラグインが未導入ならインストールしたうえでhermes import-agent <agent>を実行し(Claude Code、Codex、Cursor、OpenClaw、Grok Bot、OpenBot)、hermes migrate xaiはxaiへの参照を書き換えます67
hermes moa Mixture of Agentsのプロバイダー/モデルのスロットを設定します(モデル選択画面から選べる名前付きプリセットです)27
hermes journey(エイリアス:learning, memory-graph) 学習したskillとメモリを時系列で表示します27
hermes monitoring gatewayの監視状況を確認します(稼働状態と診断情報のエクスポート)。statusは設定、エクスポート状態、機密情報のマスキング状況を表示します27
hermes pause / hermes resume 緊急停止用です。pauseはcron/kanbanのタスク割り当てとgatewayの新しいターンを停止し、resumeは停止を解除します27
hermes peer マシン間でボット同士のDMを送受信します。接続先のHermes gatewayをadd、list、removeで管理し、dmで接続先のエージェントにメッセージを送って応答を表示します27
hermes pets petdexのアニメーション付きペットを閲覧、インストール、選択します27
hermes portal Nous Portalを設定します(ログイン、モデル選択、Tool Gateway)。login(既定)、info、open、toolsを使用できます。Nous Tool Gatewayをご覧ください2728
hermes connectors Nousのtool gatewayを通じて、ホスト型アプリのコネクターとアカウントを管理します(v0.22.0)。1つのアプリに複数の名前付きアカウントを設定することもできます。チャット内では同じ機能を/connectorsから利用できます59
hermes project プロジェクト(名前付きの複数フォルダーワークスペース)を管理します。作成、一覧表示、詳細表示、フォルダーの追加・削除、名前変更、プライマリーの設定、使用、アーカイブ、復元、kanbanボードの関連付けができます27
hermes proxy OAuthプロバイダーへのローカルのOpenAI互換プロキシです。start、status、providersを使用できます27
hermes prompt-size システムプロンプトとツールスキーマのバイト数の内訳を表示します。オフラインで実行します27
hermes send エージェントループやLLMを使わず、設定済みのプラットフォームにメッセージを送信します(スクリプト、cronジョブ、CI向け)27
hermes skin スキンの一覧表示、切り替え、調整を行います(list、use、set)27
hermes slack Slack連携を支援します。manifestは、すべてのgatewayコマンドをネイティブのスラッシュコマンドとして登録したSlackアプリのマニフェストを出力、またはファイルに書き込みます27
hermes sync デバイス間やチーム内でskillを同期します。status、pull、push、now、enable、disable、device、proposeを使用できます27
hermes whatsapp-cloud WhatsApp Business Cloud API連携を設定します(hermes whatsappのBaileysによる個人アカウント用ブリッジとは別の機能です)27
hermes worktree 蓄積したgit worktreeとマージ済みブランチを監査し、不要なものを削除します。list(エイリアスはls、audit。既定の動作)は各ツリーを経過時間、サイズ、判定、理由で分類します。pruneは安全に削除できるツリーと、完全にマージされたローカルブランチを削除します。どちらも--repo <root>に対応し、pruneではさらに--dry-run(変更せずに実行計画を表示)、--trees-only、--branches-onlyを指定できます。追跡対象ファイルの未コミット変更、未プッシュの固有コミット、使用中のツリーは削除しません。未追跡ファイルのみがある作業用ツリーは、削除前に~/.hermes/archive/worktree-prune/へアーカイブします27
hermes secrets プロセス起動時にAPIキーを取得するための外部シークレットソース(Bitwarden、1Password)を管理します27
hermes security venv、プラグイン、MCPサーバーのサプライチェーン監査(OSV.dev)を実行します(audit)27
hermes verify プロジェクトの実行手順を検出し、スモークテストを実行します27

hermes chat — メインの起動コマンド

引数なしでhermesを実行すると、対話形式のチャットが始まります。hermes chatは、オプションを指定して明示的に起動する形式です。6

hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills          # Enable specific toolsets
hermes chat --quiet -q "Return only JSON"           # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"

主なオプション:

オプション 説明
-q, --query "..." 実行するクエリです。v0.21.0で動作が変わり、実際のTTYでは対話セッションの開始時に使われます(最初のターンとしてそのまま送信されます)。--oneshotまたは-Qとの併用時や非TTY環境では、従来の単発実行と同じく、応答後に終了します40
--query-file PATH 単一のクエリをコマンドラインではなくファイルから読み込みます(-で標準入力を読み込みます)。シェルによる解釈は一切行わないため、引用符、$(...)、バッククォートはそのまま渡されます。-qとは併用できません51
--oneshot -q/--query-fileと併用し、クエリに応答して終了します(従来の単一クエリの動作)。標準入出力が非TTYの場合や、-Q/--quietの指定時には暗黙に有効になります40
-m, --model <model> 今回の実行で使用するモデルを上書きします
-t, --toolsets <csv> カンマ区切りで指定したtoolsetを有効にします
--provider <provider> プロバイダーを強制的に指定します(全一覧をご覧ください)
-s, --skills <name> このセッションで使用する1つ以上のskillを事前に読み込みます
-v, --verbose 詳細な出力を有効にします
-Q, --quiet プログラムから利用するためのモードです(バナー、スピナー、プレビューを表示しません)
--format <fmt> 単一クエリモード(-qまたは--query-file)の出力形式です。text(既定)は最終応答をプレーンテキストで出力します。stream-jsonは改行区切りのJSONイベント(JSONL)を出力します。順序はsystem/initイベント、textの差分、tool_use/tool_resultイベント、最後に終了コード・最終テキスト・トークン統計を含む1つのresultエンベロープです。stream-jsonは--quietを暗黙に有効にし、-qまたは--query-fileを必須とします(どちらもない場合は終了コード2)。--tuiとは併用できません。診断情報とセッションIDは引き続き標準エラー出力に送られ、ツール出力はイベントごとに5,000文字に制限されます(v0.21.4のリリース時期)51
--resume <session> chatから直接セッションを再開します
--worktree 分離されたgit worktreeを作成します
--checkpoints 破壊的な変更の前に、ファイルシステムのcheckpointを作成する機能を有効にします
--yolo 承認プロンプトをスキップします
--source <tag> セッションの発生元を示すタグです(既定はcli。外部連携にはtoolを使用します)
--max-turns <N> 会話の1ターンあたりのツール呼び出し反復回数の上限です(v0.20.0以降の既定値は500、または設定のagent.max_turnsに従います)40

hermes setup — 全体のセットアップウィザード

セットアップウィザード全体を実行するか、特定のセクションに直接進みます。6

hermes setup                 # Full wizard
hermes setup model           # Provider and model only
hermes setup terminal        # Terminal backend only
hermes setup gateway         # Messaging platforms only
hermes setup tools           # Tool enable/disable per platform
hermes setup agent           # Agent behavior only
hermes setup --non-interactive
hermes setup --reset         # Reset config to defaults before setup

hermes logs — 構造化ログの照会

hermes logsでは、ログレベル、セッションID、時間範囲で同時に絞り込めるため、ログファイルに対してtail -fを実行するよりも柔軟に調べられます。6

hermes logs                          # Last 50 lines of agent.log
hermes logs -f                       # Follow in real time
hermes logs gateway -n 100           # Last 100 lines of gateway.log
hermes logs --level WARNING --since 1h   # Warnings from the last hour
hermes logs --session abc123         # Filter by session ID substring
hermes logs errors --since 30m -f    # Follow errors.log from 30m ago
hermes logs list                     # List all log files with sizes

ログファイルは~/.hermes/logs/に保存されます。6 - agent.log — エージェントのすべてのアクティビティ(API呼び出し、ツールの実行振り分け、セッションのライフサイクル、INFO以上) - errors.log — 警告とエラーのみ(agent.logから絞り込んだ内容) - gateway.log — メッセージングgatewayのアクティビティ(プラットフォーム接続、処理の振り分け、Webhook)

ログのローテーションは、PythonのRotatingFileHandlerによって自動で行われます。agent.log.1、agent.log.2などを確認してください。6

hermes doctor — 診断

問題が起きたときに最初に実行するコマンドは、hermes doctor [--fix]です。設定の妥当性、依存関係の有無、APIキーの利用可否、サービスの状態を確認し、--fixを指定すると自動修復も試みます。6

診断情報を誰かに共有するには、hermes dumpを使用してください。APIキーをマスキングした簡潔なプレーンテキストの概要が出力されるので、GitHubのIssueやDiscordのスレッドにそのまま貼り付けられます。6


スラッシュコマンド

スラッシュコマンドは、アクティブなチャットセッション(CLI またはメッセージングプラットフォーム)内で実行します。hermes_cli/commands.py にある共通の COMMAND_REGISTRY から呼び出されるため、ほとんどのコマンドはどのインターフェースでも同じように動作します。9

セッション制御

コマンド 説明
/new(別名 /reset) 新しいセッションを開始します
/clear 画面をクリアし、新しいセッションを開始します
/history 会話履歴を表示します
/save 現在の会話を保存します
/retry 最後のメッセージを再試行します
/undo 最後のユーザーとアシスタントのやり取りを削除します
/title <name> 現在のセッションにタイトルを設定します
/compress 会話のコンテキストを手動で圧縮します
/rollback [number] ファイルシステムの checkpoint を一覧表示または復元します
/stop 実行中のバックグラウンドプロセスをすべて強制終了します
/status セッション、モデル、トークン、コンテキストの情報を表示します。v0.20.5 前後の更新以降は、推論モード、承認待ちの項目、コンテキスト使用量も表示します4035
/queue <prompt> 次のターンで使うプロンプトをキューに追加します。注意点: /q は /queue と /quit の両方に割り当てられています。後から登録された方が優先され、実際には /quit として解釈されるため、必ず /queue と省略せずに入力してください。9
/resume [name] 以前に名前を付けたセッションを再開します
/statusbar(別名 /sb) コンテキストとモデルのステータスバーの表示を切り替えます
/background <prompt>(別名 /bg) 別のバックグラウンドセッションでプロンプトを実行します
/btw <question> 一時的な補足質問をします(ツールは使わず、保存もされません)
/plan [request] 同梱の plan skill を読み込み、実行する代わりに計画を作成します
/branch [name](別名 /fork) 現在のセッションを分岐します
/goal <target> エージェントに目標を固定し、ターンをまたいでもその達成に集中させます。Ralph-loop パターンを基本機能として組み込んでおり、ターン数の上限も設定できます。v0.13.0 で追加されました。18
/subgoal <criterion> ループを再開せずに、実行中の /goal に成功条件を追加します。v0.14.0 で追加されました。19
/handoff <target> メッセージ、ツール呼び出し、コンテキストを含む進行中のセッションを、別のモデル、ペルソナ、または profile に引き継ぎます。v0.14.0 で追加されました。19
/worktree [new [name]\|list\|prune [--dry-run]] セッションを離れずに、分離された git worktree の確認、作成、整理ができます。new はリポジトリの .worktrees/ 配下に worktree を作成し、そこへセッションを移します。list は一覧を表示します。prune は hermes worktree prune と同じく、ユーザーの立ち会いのもとで不要な worktree を整理します。ドキュメントによると、「セッションが実行されているツリーには一切触れません」27

設定とモデル

コマンド 説明
/config 現在の設定を表示します
/model [model-name] 現在のモデルを表示または変更します。/model resetはチャットの上書きを解除し、profileに設定されたモデルに戻します(gatewayとDesktopのチャット、v0.22.6のリリース時期)67
/provider 利用可能なプロバイダーと現在のプロバイダーを表示します
/personality [name] パーソナリティの追加設定を適用します
/verbose ツールの進捗表示を順に切り替えます
/reasoning 推論の強度と表示を管理します。v0.19.0 では強度に max と ultra が追加され、/reasoning の設定はセッション単位になりました。また、設定ファイルでモデルごと、MoA スロットごとに強度を上書きできます70
/skin 表示スキンやテーマを表示または変更します
/voice [on\|off\|tts\|status] CLI の音声モードを切り替えます
/yolo YOLO モード(承認プロンプトを省略)を切り替えます。v0.19.0 以降は、YOLO モードでもユーザー定義の拒否ルールに一致するコマンドはブロックされます70
/fast Fast Mode を切り替えます。OpenAI と Anthropic のモデルで優先処理を利用できます(v0.9.0 以降)16
/debug すべてのプラットフォームで簡易診断を実行します(v0.9.0 以降)16
/subscription ターミナルから Nous Portal のプランを管理します。プランと残りの利用枠の確認、アップグレードやダウングレードの費用プレビュー、変更の適用と取り消しができます(v0.19.0 以降)70
/topup ターミナルを離れずに Nous Portal の残高にクレジットを追加します(v0.19.0 以降)70

セッションの途中でプロバイダーを切り替えるときは、主に /model コマンドを使います。9

/model                              # Show current model and options
/model claude-sonnet-4              # Switch model (auto-detect provider)
/model zai:glm-5                    # Switch provider:model
/model custom:qwen-2.5              # Use model on custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Named custom provider
/model openrouter:anthropic/claude-sonnet-4   # Back to cloud

v0.19.0 では /model --once が追加されました。1 ターンだけモデルを変更し、応答後は自動的に元のモデルに戻ります。70 v0.20.5 前後の更新以降は、/model の選択画面があいまい検索にも対応し、入力に応じて候補を絞り込みます。2335

ツール、skill、情報

コマンド 説明
/tools [list\|disable\|enable] [name...] 現在のセッションで使うツールを管理します
/toolsets 利用可能な toolset を一覧表示します
/browser [connect\|disconnect\|status] ローカルの Chrome CDP 接続を管理します
/skills skill の検索、インストール、詳細確認、管理を行います
/cron スケジュールされたタスクを管理します
/reload-mcp config.yaml から MCP サーバーを再読み込みします
/connectors コネクターのオーバーレイを開きます。ホスト型アプリと自分の MCP サーバーを1つの一覧で確認でき、アプリごとにサインインできます(v0.22.0)59
/plugins インストール済みのプラグインを一覧表示します
/help すべてのコマンドを表示します
/usage トークン使用量、費用、所要時間を表示します
/insights 過去30日間の利用状況の分析を表示します
/platforms メッセージングプラットフォームの状態を表示します
/profile 使用中の profile の名前とホームを表示します
/palette あいまい検索に対応したコマンドパレットを開きます(Ctrl+P でも開けます)。すべてのコマンドと skill をあいまい検索できます。v0.20.5 前後の更新で追加されました4035

skill から動的に追加されるスラッシュコマンド

インストールしたすべての skill は、自動的にスラッシュコマンドとして利用できるようになります。9

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw       # Just the skill name loads it and lets the agent ask what you need

v0.19.0 以降は、スラッシュコマンドによる skill の呼び出しを重ねて指定できます。/skill-a /skill-b do XYZ と入力すると、1つのターンで両方の skill を順番に読み込みます。連続して指定する名前にも、自動補完とゴーストテキストによる入力候補の表示が使えます。70

config.yaml には、長いプロンプトに短い名前を割り当てるクイックコマンドも定義できます。9

quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
  morning: "Check my calendar, unread emails, and summarize today's priorities"

定義したら、CLI で /review、/deploy、または /morning と入力します。

前方一致

コマンドは前方一致に対応しています。/h は /help、/mod は /model として解釈されます。入力した接頭辞が複数のコマンドに一致する場合は、レジストリ内で最初に登録されたものが優先されます。完全なコマンド名と登録済みの別名は、常に前方一致よりも優先されます。9

メッセージング専用コマンド

一部のコマンドは、メッセージングプラットフォーム(Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant)でのみ動作します。9

  • /status — セッション情報を表示します(現在はメッセージング専用ではありません。セッション制御を参照してください)
  • /sethome(別名 /set-home) — 現在のチャットをプラットフォームのホームに設定します
  • /approve [session|always] — 承認待ちの危険なコマンドを承認します
  • /deny [reason] — 承認待ちの危険なコマンドを拒否します。v0.19.0 以降は、/deny <reason> で拒否理由をエージェントに伝えられるため、理由を知らずに再試行するのではなく、方針を修正できます70
  • /update — Hermes Agent を最新版に更新します
  • /commands [page] — すべてのコマンドと skill を閲覧します(ページ分割表示)

また、/skin、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/statusbar、/plugins は CLI 専用です。9


ツールとtoolset

Hermesには、ウェブ検索、ブラウザー自動化、ターミナル実行、ファイル編集、メモリ、委任、RLトレーニング、メッセージ配信、Home Assistant連携など、幅広い機能を網羅するツールレジストリが組み込まれています。10 ツールは用途別のtoolsetにまとめられており、プラットフォームごとに有効・無効を切り替えられます。

主なカテゴリ

カテゴリ 例 説明
ウェブ web_search, web_extract ウェブを検索し、ページの内容を抽出します
ターミナルとファイル terminal, process, read_file, patch コマンドの実行とファイル操作を行います
ブラウザー browser_navigate, browser_snapshot, browser_vision テキストと視覚情報を使ってブラウザーを対話的に自動操作します
メディア vision_analyze, video_analyze, video_generate, image_generate, text_to_speech マルチモーダルな分析と生成を行います。video_analyzeはGeminiを優先し、互換性のあるマルチモーダルプロバイダーへの対応も拡張できます(v0.13.0以降)。v0.14.0では、プロバイダーのバックエンドを差し替えられる統合版video_generateが追加されました。また、使用中のモデルが画像認識に対応している場合、vision_analyzeを通じて生のピクセルデータを送信します。1819
エージェントのオーケストレーション todo, clarify, execute_code, delegate_task 計画、確認、コード実行、サブエージェントへの委任を行います
コンピューター操作 computer_use cua-driverバックエンド経由でデスクトップを操作します。v0.14.0では、Anthropic以外の画像認識対応プロバイダーでも利用できるようになりました。19
メモリと想起 memory, session_search 永続メモリとセッション検索を提供します
自動化と配信 cronjob, send_message タスクのスケジュール実行とメッセージ送信を行います
外部連携 ha_*, MCPのツール, rl_* Home Assistant、MCP、RLトレーニングと連携します

よく使われるtoolset名には、web、terminal、file、browser、vision、image_gen、moa、skills、tts、todo、memory、session_search、cronjob、code_execution、delegation、clarify、homeassistant、rlなどがあります。10

ツールの管理

hermes chat --toolsets "web,terminal"       # Use specific toolsets
hermes tools                                # Interactive per-platform tool config
hermes tools --summary                      # Print enabled-tools summary

セッションの途中でも、/tools disable <name>と/tools enable <name>でツールの有効・無効を切り替えられます。変更後のツール構成を反映するため、セッションはリセットされます。9

ターミナルのバックエンド

ターミナルツールには7種類の実行バックエンドが組み込まれています。v0.20.6以降では、プロバイダー選択と同様に、プラグインでバックエンドを追加できるようになりました(後述)。1024

バックエンド 用途
local 手元のマシンで実行します(デフォルト)。開発や信頼できるタスクに適しています
docker 隔離されたコンテナで実行します。セキュリティと再現性を確保できます
ssh リモートサーバーで実行します。サンドボックス化し、エージェントを自身のコードから隔離できます
singularity HPCコンテナで実行します。クラスターコンピューティングに対応し、root権限は不要です
modal サーバーレスクラウドで実行します
daytona クラウド上のサンドボックスワークスペースです。永続的なリモート開発環境を利用できます
vercel_sandbox Vercel SandboxのクラウドmicroVMです。スナップショットによるファイルシステムの永続化に対応したクラウド実行環境です。hermes-agent[vercel]をインストールし、terminal.vercel_runtime(node24、node22、python3.13のいずれか)を設定して、VERCEL_TOKEN、VERCEL_PROJECT_ID、VERCEL_TEAM_IDで認証します。リモートワークスペースのルートは、デフォルトで/vercel/sandboxです24

バックエンドはhermes config set terminal.backend <name>で切り替えるか、config.yamlで設定します。

terminal:
  backend: docker      # or: local, ssh, singularity, modal, daytona, vercel_sandbox
  cwd: "."             # Working directory
  timeout: 180         # Command timeout in seconds

プラグインによるバックエンド(v0.20.6以降)。 サードパーティーのサンドボックスベンダーは、コアリポジトリに実装を取り込んでもらう必要がなくなりました。プラグインが読み込み時にPluginContext.register_terminal_environment_providerを通じてTerminalEnvironmentProviderを登録すると、組み込みバックエンドと同じように、その登録名をterminal.backendで選択できます。組み込みの名前は予約済みで、コアに含まれるバックエンドと名前が重複するプロバイダーはレジストリに拒否されます。また、コアはバックエンドを判別する各箇所で、ハードコードされた名前のリストではなくレジストリを参照します。そのため、登録したバックエンドは、コアのすべての関連機能(hermes setupのバックエンド選択、ダッシュボードの疎通確認ステータス、hermes doctorのチェック、コンテナのパスとcwdの処理、シークレットの除去)に自動的に組み込まれます。32

SSHバックエンド(エージェントが自身のコードを変更できないため、セキュリティ面で推奨します)。10

terminal:
  backend: ssh
# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Dockerバックエンド:

terminal:
  backend: docker
  docker_image: python:3.11-slim

コンテナのリソース(docker、singularity、modal、daytonaに適用されます)。10

terminal:
  container_cpu: 1
  container_memory: 5120          # MB (default 5GB)
  container_disk: 51200           # MB (default 50GB)
  container_persistent: true      # Persist filesystem across sessions

container_persistent: trueを設定すると、インストール済みのパッケージ、ファイル、設定がセッションをまたいで保持されます。10

すべてのコンテナバックエンドには、セキュリティ強化策が適用されます。ルートファイルシステムの読み取り専用化(Docker)、DAC_OVERRIDE、CHOWN、FOWNER以外のすべてのLinuxケーパビリティの削除、権限昇格の禁止、PID数の制限(256プロセス)、名前空間の完全な隔離、ボリュームによるワークスペースの永続化です。10

バックグラウンドプロセス

ターミナルツールはバックグラウンド実行に対応しており、プロセスを明示的に管理できます。10

terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}

process(action="list")                            # Show all running processes
process(action="poll", session_id="proc_abc123")  # Check status
process(action="wait", session_id="proc_abc123")  # Block until done
process(action="log", session_id="proc_abc123")   # Full output
process(action="kill", session_id="proc_abc123")  # Terminate
process(action="write", session_id="proc_abc123", data="y")  # Send input

PTYモード(pty=true)では、CodexやClaude Codeなどの対話型CLIツールを利用できます。10

Sudo

コマンドにsudoが必要な場合、Hermesがパスワードの入力を求めます(セッション中はキャッシュされます)。または、~/.hermes/.envにSUDO_PASSWORDを設定することもできます。10


マルチエージェントKanban(v0.13.0以降)

v0.13.0では、マルチエージェントの連携が中核的な機能になりました。永続的なKanbanボードにより、複数のエージェント間で、再起動をまたいでも、タスク、ステータス、ワーカーの識別情報を追跡できます。18 このボードがあることで、Hermesワーカーの群れは、途絶えた引き継ぎで停滞することなく、作業を最後まで進められます。

仕組み 動作
ハートビート 各ワーカーはタスクを担当している間、定期的に生存通知を送ります。ハートビートが途絶えると、そのワーカーは異常の疑いありと判定され、タスクは別のワーカーが引き継げる状態になります。
引き継ぎ 別のワーカーが、放置されたタスクを完全なタスク状態とそれまでの部分的な出力ごと引き継げます。
ゾンビ検出 タスクを完了扱いにせず終了したワーカーは、新しい作業の取得を自動的にブロックされます。これにより、稼働していないワーカーの識別情報が群れに蓄積するのを防ぎます。
ハルシネーション検査 出力が検査に通らなかった場合、タスクは完了扱いにならず、理由を添えてボードに戻されます。
タスクごとのmax_retries 失敗しやすいことが分かっているタスクでは、デフォルトの再試行回数を上書きできます。
複数プロジェクトのボード 1つのHermesホームに、独立したボードを複数配置できます。

Kanbanボードは、目標の管理を担う/goal(目標を固定したRalphループ)や、ワーカーの起動を担う既存のdelegate_taskツールと自然に組み合わせられます。こうして、次に何をするか、誰が担当しているか、どこで行き詰まっているかについて、すべてのエージェントが同じ確定情報を共有する群れの運用パターンが実現します。

Hermesの群れとは?

群れ(swarm)とは、1つの共有Kanbanボードを使って並列に稼働する複数のHermesワーカーです。 別途有効にするサブシステムではなく、ボードによって実現する運用形態です。ボードが提供するのは、 並列エージェントだけでは用意できない、唯一の確定情報です。 次にどの作業を引き受けるべきか、すでに誰かが取り組んでいるかを判断できます。

v0.15.0では、このパターンが正式にサポートされる構成となり、並列ワーカーの連携に対応する 群れのトポロジー、上位目標からサブタスクへの自動分解、 タスクごとのモデル指定、タスクのスケジュール実行、worktree管理が追加されました。これにより、並列 ワーカーが同じチェックアウト内で競合するのを防げます。73

単純なマルチエージェント構成で起こる問題 ボードによる対処
2つのワーカーが同じタスクを取得してしまいます ワーカーの識別情報を記録し、タスクの担当を確定します
ワーカーがタスクの途中で停止し、作業内容が失われます ハートビートの途絶を検知し、それまでの部分的な出力とともにタスクを引き継ぎます
クラッシュしたワーカーがタスクをいつまでも「保持」し続けます ゾンビ検出により、新しい作業の取得をブロックします
すべてのサブタスクに同じ高コストのモデルを使います タスクごとにモデルを指定でき、定型的なサブタスクには低コストのモデルを使えます
並列ワーカーが同じファイルを編集します worktree管理により、各ワーカーのチェックアウトを隔離します

実際の流れは、群れに目標を与え、自動分解でボード上のタスクに分割し、 ワーカーがそれを取得・実行して結果を返す、というものです。再試行回数はタスクごとに設定されるため(max_retries)、 1つの失敗しやすいサブタスクが実行全体の再試行枠を使い切ることはありません。ボードの状態は 永続化されるため、再起動しても群れは作業を継続できます。ワーカーが再接続し、同じ状態から再開します。

群れの成果は、タスク分解の質に左右されます。 ボードが担うのはワーカー間の調整であり、 不適切に分割された目標を改善してくれるわけではありません。暗黙の共有状態に依存するタスクは、 worktreeの有無にかかわらず競合します。


skillシステム

skillは、エージェントが必要に応じて読み込めるオンデマンドの知識ドキュメントです。トークン使用量を抑えるために段階的開示のパターンを採用しており、agentskills.ioのオープン標準に準拠しています。11

すべてのskillは~/.hermes/skills/に保存されます。ここが主要なディレクトリであり、正本の保存先です。新規インストール時には、同梱のskillがリポジトリからコピーされます。Hubからインストールしたskillやエージェントが作成したskillも、ここに保存されます。11

段階的開示

Level 0: skills_list()           → [{name, description, category}, ...]   (~3k tokens)
Level 1: skill_view(name)        → Full content + metadata                 (varies)
Level 2: skill_view(name, path)  → Specific reference file                 (varies)

エージェントは、実際に必要になったときだけskillの内容全体を読み込みます。11

SKILL.mdの形式

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macos, linux]      # Optional — restrict to OS platforms
metadata:
  hermes:
    tags: [python, automation]
    category: devops
    fallback_for_toolsets: [web]     # Conditional activation
    requires_toolsets: [terminal]    # Conditional activation
    config:                          # Config.yaml settings
      - key: my.setting
        description: "What this controls"
        default: "value"
        prompt: "Prompt for setup"
---

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

条件付きの有効化

skillは、利用可能なツールに応じて表示・非表示を切り替えられます。特に便利なのがフォールバック用のskillです。有料ツールを利用できない場合にのみ表示する、無料またはローカルの代替手段として使えます。11

フィールド 動作
fallback_for_toolsets 指定されたtoolsetが利用可能な場合、skillを非表示にします
fallback_for_tools 同様ですが、個々のツールを確認します
requires_toolsets 指定されたtoolsetが利用できない場合、skillを非表示にします
requires_tools 同様ですが、個々のツールを確認します

例: 組み込みのduckduckgo-search skillは、fallback_for_toolsets: [web]を使用します。FIRECRAWL_API_KEYを設定している場合、web toolsetが利用可能となり、エージェントはweb_searchを使用します。この間、DuckDuckGoのskillは非表示のままです。APIキーがない場合は、DuckDuckGoのskillがフォールバックとして自動的に表示されます。11

エージェントが管理するskill

エージェントはskill_manageツールを使って、自身のskillを作成・更新・削除できます。これはエージェントの手続き記憶にあたります。複雑なワークフローの進め方を見つけると、後で再利用できるようにskillとして保存します。11

エージェントがskillを作成するタイミング:11 - 複雑なタスク(ツール呼び出しが5回以上)を正常に完了した後 - エラーや行き詰まりに直面し、うまくいく方法を見つけたとき - ユーザーがエージェントの進め方を修正したとき - 複雑なワークフローを見つけたとき

操作:11

操作 用途
create skillを新規作成します
patch 対象を絞って修正します(推奨:トークン効率が最も高い方法です)
edit 構造を大幅に書き直します
delete skillを完全に削除します
write_file 補助ファイルを追加・更新します
remove_file 補助ファイルを削除します

ロックされたskill(v0.22.6のリリース時期)。 hermes curator lock <skill>は、pinnedと並んで保存されるユーザーの宣言です。ロックされたskillは、エージェントがどの書き込み経路(skill_manage、ターミナル、curator)からも変更できません。hermes curator unlock <skill>で解除し、hermes curator statusでロック中の一覧を表示できます。DesktopのCapabilitiesペインにも同じスイッチがあります。67

Skill Hub

オンラインレジストリのskillを閲覧・検索・インストール・管理できます。611

hermes skills browse                          # Browse all hub skills
hermes skills browse --source official        # Browse official optional skills
hermes skills search kubernetes               # Search all sources
hermes skills search react --source skills-sh # Search skills.sh directory
hermes skills inspect openai/skills/k8s       # Preview before installing
hermes skills install openai/skills/k8s       # Install with security scan
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check                           # Check for upstream updates
hermes skills update                          # Reinstall changed hub skills
hermes skills audit                           # Re-scan installed hub skills
hermes skills uninstall k8s
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills tap add myorg/skills-repo       # Add custom GitHub source

統合されているHubの取得元:11

取得元 例 備考
official official/security/1password Hermesに同梱されるオプションのskill(組み込みと同じ信頼レベル)
skills-sh skills-sh/vercel-labs/agent-skills/vercel-react-best-practices Vercelの公開skillディレクトリ
well-known well-known:https://mintlify.com/docs/.well-known/skills/mintlify /.well-known/skills/index.jsonを公開するサイトからのURLベースの検出
github openai/skills/k8s GitHubのリポジトリ/パスからの直接インストール
clawhub — サードパーティーのskillマーケットプレイス
lobehub — LobeHubのエージェントカタログからの変換
browse-sh — Browserbaseのskill取得元

デフォルトのGitHub tap(設定なしで閲覧可能)は、openai/skills、anthropics/skills、huggingface/skills、NVIDIA/skills、garrytan/gstackです。claude-marketplaceはv0.20.0で取得元から削除され、取得元一覧ではbrowse-shに置き換えられました。1169

セキュリティスキャン

Hubからインストールするすべてのskillは、セキュリティスキャナーによる検査を受けます。データの不正な外部送信、プロンプトインジェクション、破壊的なコマンド、サプライチェーン攻撃の兆候などの脅威が確認されます。11

信頼レベル:11

レベル 取得元 ポリシー
builtin Hermesに同梱 常に信頼されます
official リポジトリ内のoptional-skills/ 組み込みと同じ信頼レベルで、サードパーティーの警告は表示されません
trusted 信頼済みのレジストリ(openai/skills、anthropics/skills) より許容範囲の広いポリシーが適用されます
community 上記以外すべて 危険とは判定されていない検出事項は--forceで無視できますが、dangerous判定によるブロックは解除できません

--forceを使うと、コミュニティのskillに対する、危険とは判定されていないポリシー上のブロックを解除できます。ただし、スキャン結果がdangerousの場合は解除できません。11

外部skillディレクトリ

Hermesに追加のskillディレクトリを指定し、ローカルのディレクトリとあわせてスキャンできます。11

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

パスでは、~の展開と${VAR}による環境変数の置換を利用できます。外部ディレクトリは読み取り専用です。エージェントがskillを作成・編集する際は、常に~/.hermes/skills/に書き込みます。同じ名前のskillが両方にある場合は、ローカルのものが優先されます。11

固定読み込みするskill:skills.auto_load(v0.21.4の時期)

config.yamlのskills.auto_loadに列挙したskillは、新しいセッションごとに内容全体が必ず読み込まれます。これはCLI、TUI、gateway、cron、APIのいずれにも適用されます。51

skills:
  auto_load:
    - team-conventions
    - deploy-checklist

このリストは、エージェントのプロンプトが最初に構築されるときに1度だけ解決されます。指定した名前のskillが存在しない場合や無効になっている場合は、セッションを失敗させず、警告を出してスキップします。また、HERMES_IGNORE_RULES(--ignore-rulesの内部で使われる仕組み)を使うと、自動挿入されるほかのコンテキストと同様に、このリストも適用されなくなります。1つのセッションにだけskillを事前に読み込む-s/--skillsを補完し、常時適用する指示として使える機能です。51


永続メモリ

Hermesには、容量に上限があり、内容を選別しながらセッションをまたいで保持するメモリがあります。エージェントのメモリは2つのファイルで構成され、どちらも~/.hermes/memories/に保存されます。12

ファイル 用途 文字数の上限
MEMORY.md エージェント自身のメモ — 環境に関する事実、規約、学んだこと 2,200文字(約800トークン)
USER.md ユーザーのprofile — 好み、コミュニケーションスタイル、期待すること 1,375文字(約500トークン)

どちらも、セッション開始時に固定されたスナップショットとしてシステムプロンプトに挿入されます。エージェントはmemoryツールのadd、replace、removeを使って、自分のメモリを管理します。12

固定スナップショットの仕組み: システムプロンプトに挿入する内容は、セッション開始時に1度だけ取得され、セッションの途中では変わりません。これは意図的な設計で、LLMのプレフィックスキャッシュを維持し、性能を保つためです。セッション中の変更はすぐにディスクへ保存されますが、システムプロンプトに反映されるのは次のセッションからとなります。12

保存する内容

保存するもの(エージェントが自発的に保存します):12 - ユーザーの好み: 「JavaScriptよりTypeScriptを好みます」 → user - 環境に関する事実: 「このサーバーはDebian 12で稼働し、PostgreSQL 16を使用しています」 → memory - 訂正事項: 「ユーザーはdockerグループに所属しているので、Dockerコマンドではsudoを使わないでください」 → memory - 規約: 「このプロジェクトではタブを使い、1行は120文字、docstringはGoogleスタイルに従います」 → memory - 完了した作業: 「2026年1月15日にデータベースをMySQLからPostgreSQLへ移行しました」 → memory

保存しないもの:12 - 些細な情報や自明な情報 - 簡単に調べ直せる事実 - 生データのダンプ(メモリに収めるには大きすぎます) - そのセッションでしか役に立たない一時的な情報 - コンテキストファイルにすでに記載されている情報

MEMORY.mdとUSER.mdに加えて、エージェントはsession_searchツールで過去の会話を検索できます。すべてのCLIセッションとメッセージングセッションはSQLite(~/.hermes/state.db)に保存され、FTS5による全文検索に対応しています。v0.15.0の再設計以降、このツールはLLMを一切使用せず、保存された会話内容を直接返します(出典では「単一形式のツールがDBの内容を直接返す」と表現されています)。これにより、4,500倍の高速化とAPIコストの解消が実現しました。127334

特徴 永続メモリ セッション検索
容量 合計約1,300トークン 無制限(すべてのセッション)
速度 即時(システムプロンプト内に存在) FTSクエリ1回 — v0.15.0以降はLLMの呼び出しなし
用途 重要な事実を常に参照可能にする 過去の特定の会話を探す
管理 エージェントが手動で内容を選別 自動 — すべてのセッションを保存
トークンコスト セッションごとに固定(約1,300トークン) 必要に応じて発生

v0.21.4前後には2つの機能が追加され、どちらもタグv2026.9.21で確認済みです。1つ目は時間範囲の指定です。セッションを探す検索形式では、after(セッション開始時刻の下限、指定時刻を含む)とbefore(上限、指定時刻を含まない)を受け取れます。それぞれISO形式の日付・日時、または相対的な期間(7d、24h、2w)を指定でき、日付のみの場合はその日のUTC午前0時を意味します。これらは、実際に期間が明示されている検索にだけ使うためのものです。sortは引き続き順位付けを調整する指定であり、検索範囲を制限するものではありません。2つ目は、結果が0件の場合に取りこぼしを減らす再検索です。FTS5では検索語の間に暗黙のAND条件が入るため、複数の語で言い換えたクエリでは、そのうち1語でも含まない保存済みの文が検索から漏れることがあります。そこで、元のクエリと部分文字列による代替検索がすべて0件だった場合は、いずれかの検索語に一致する条件でインデックスを再検索し、より多くの語を含む行を上位に並べます。再検索は結果が0件の場合に限られるため、元の検索でヒットした場合の一致条件は変わりません。また、OR/NOTを明示したクエリ、単一語のクエリ、CJK向けの検索経路に振り分けられたクエリには適用されません。51

外部メモリプロバイダー

MEMORY.mdとUSER.mdを超える高度な永続メモリのために、Hermesのv0.22.0には、RetainDBとByteRoverという2つの外部メモリプロバイダープラグインが同梱されています。さらに6つをプラグインカタログからインストールできます。v0.21.7でコアのソースツリーから移されたHolographic、v0.21.6で移されたHoncho、OpenViking、Mem0、Supermemory、v0.21.5で移されたHindsightです。この6つはいずれも各ベンダーが保守するコミュニティ枠のプラグインです。12555759

Hindsightはv0.21.4までコアのソースツリーに同梱されていましたが、v0.21.5でカタログへ移され、Vectorizeが保守しています。Honcho、Mem0、OpenViking、Supermemoryはv0.21.6で、Holographicはv0.21.7で同様に移されました。既存の設定は自動的に移行されます。memory.providerにこれらのいずれかが指定されていれば、hermes updateによって、そのプロバイダーを指定しているすべてのprofileのホームにカタログのプラグインがインストールされます。それでも未インストールの場合は、エージェントの初回起動時にインストールされます。security.allow_lazy_installs: falseの場合、エージェント起動時にはメッセージがログに記録されるだけなので、hermes plugins install <name>を手動で実行してください。プラグインは~/.hermes/plugins/<name>/に配置され、plugins.enabledに追加されます。memory.provider、memory.hindsight.*、HINDSIGHT_API_KEY、メモリデータはそのまま維持されます。hermes memory statusとhermes plugins listで確認できます。pipの追加依存指定hermes-agent[hindsight]は廃止されています。53

外部プロバイダーは組み込みメモリと並行して動作し、置き換えることはありません。ナレッジグラフ、意味検索、事実の自動抽出、セッションをまたぐユーザーモデリングなどの機能を追加します。612

hermes memory setup         # Pick a provider and configure it
hermes memory status        # Check what's active
hermes memory off           # Disable external provider (built-in only)

同時に有効にできる外部プロバイダーは1つだけです。組み込みメモリは常に有効です。6

セッションの自動再開(v0.13.0以降)

v0.13.0では、エージェントの処理が途中で中断されても復帰できるようになりました。gatewayは再起動後に中断されたセッションを自動再開します。/updateによる再起動では、アップグレード中もセッション状態が保持されます。また、開発中にソースファイルを再読み込みしても、新しいセッションに切り替わらず、進行中のセッションが維持されます。18 これにより、長時間にわたるgatewayの処理やcronで実行するジョブでも、プロセスの再起動時にコンテキストウィンドウがリセットされなくなりました。

checkpoint v2(v0.13.0以降)

v0.13.0では、状態の永続化が単一ストア設計へと書き直され、実際に古いデータを削除する仕組み、ディスク使用量の保護策、孤立したシャドウリポジトリを残さない仕組みが導入されました。18 以前のcheckpointシステムでは、長期間稼働するprofileでディスク上に状態データが蓄積していました。v2ストアは、ローカルのcheckpoint保存容量に厳格な上限を設け、容量増加の原因となっていた管理情報の重複を解消します。ユーザー側で設定を変更する必要はなく、次のcheckpoint書き込みからv2の処理が使われます。


パーソナリティとSOUL.md

SOUL.mdは、Hermesインスタンスの基本となるアイデンティティを定義します。システムプロンプトの第1スロットに配置され、ハードコードされたデフォルトのアイデンティティを置き換えます。13

Hermesは、デフォルトのSOUL.mdを~/.hermes/SOUL.mdに自動作成します(カスタムprofileの場合は$HERMES_HOME/SOUL.md)。既存のユーザーファイルを上書きすることはありません。SOUL.mdの読み込み元はHERMES_HOMEのみで、現在の作業ディレクトリは検索しません。このため、プロジェクトが変わってもパーソナリティは一貫します。13

SOUL.mdに記載する内容

長く使い続ける語り口やパーソナリティの指針を記載します。13 - 口調 - コミュニケーションスタイル - どこまで率直に伝えるか - 基本的な対話の進め方 - 文体や表現で避けること - 不確実なこと、意見の相違、曖昧さにHermesがどう対応するか

次の内容は、なるべく別の場所に記載してください:13 - 一度限りのプロジェクト指示 - ファイルパス - リポジトリの規約 - 一時的なワークフローの詳細

これらはSOUL.mdではなく、AGENTS.mdに記載します。

SOUL.mdとAGENTS.mdの違い

Hermesのアイデンティティを管理するうえで、最も重要なのはこの区別です。13

SOUL.md — アイデンティティ、口調、文体、コミュニケーションの基本方針、パーソナリティに関わる振る舞いです。

AGENTS.md — プロジェクトのアーキテクチャ、コーディング規約、ツールの選好、リポジトリ固有のワークフロー、コマンド、ポート、パス、デプロイに関するメモです。

判断の目安は、どこでも引き継ぎたい内容ならSOUL.md、プロジェクトに紐づく内容ならAGENTS.mdです。13

組み込みのパーソナリティ

Hermesには、/personalityで切り替えられるパーソナリティが用意されています。1333

名前 説明
helpful 親しみやすい汎用アシスタント
concise 短く要点を押さえた回答
technical 詳細かつ正確に説明する技術の専門家
creative 斬新で常識にとらわれない発想
teacher わかりやすい例を使い、根気よく教える先生
kawaii かわいい表現、きらめき、元気いっぱいの語り口
catgirl 猫らしい表現を使うネコちゃん
pirate 技術に詳しい海賊、Hermes船長
shakespeare 劇的な趣を添えた詩人風の文章
surfer 気さくでのんびりした仲間のような雰囲気
noir ハードボイルドな探偵風の語り
uwu uwu口調でかわいさ全開
philosopher あらゆる問いを深く考察
hype テンション最高潮

config.yamlで定義するカスタムパーソナリティ:13

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

その後、/personality codereviewerで切り替えます。

SOUL.mdと/personalityの違い

SOUL.mdは基本の語り口を定め、/personalityはセッション単位でその上に重ねる設定です。13 SOUL.mdには実用的なデフォルトを設定しておき、学習を支援する会話では/personality teacher、ブレインストーミングでは/personality creativeを使いましょう。


Nous Tool Gateway(v0.10.0+)

Hermes Agent v0.10.0(2026年4月16日)以降、有料の Nous Portal サブスクライバーは、既存の Portal 認証情報を使って、厳選されたツール群にマネージドサービスとしてアクセスできます。管理する API キーを追加する必要はありません。75 Hermes CLI 自体は引き続き MIT ライセンスで提供される、完全なオープンソースです。変わったのは、Portal の認証でモデル推論以外も利用できるようになった点です。

最も手早く始めるには hermes setup --portal を使います。README では「新規インストールからコマンド1つで」と紹介されており、OAuth でログインし、プロバイダーを Nous に設定して、Tool Gateway を有効にします。その後は hermes portal で連携を管理できます。hermes portal login(サブコマンドを省略した場合の既定の動作)は、同じ初期設定を一括で実行します。hermes portal info は「Portal 認証と Tool Gateway のルーティング概要」を表示し、hermes portal open は既定のブラウザーでサブスクリプションページを開きます。hermes portal tools は gateway のツール一覧と、Nous 経由で処理されるツールを表示します。hermes portal status は、後方互換性のために info の非表示のエイリアスとして残っています。また、そのタグのドキュメントにある CLI リファレンスでもサブコマンド名は status のままなので、どちらも使用できます。28

gateway で利用できるツール

ツール プロバイダー 用途
ウェブ検索 Firecrawl 最新情報を必要とするエージェント向けの情報取得
画像生成 FAL / FLUX 2 Pro FAL キーを設定せずに、その場で画像を生成
音声合成 OpenAI TTS メッセージング gateway での音声出力
ブラウザー自動化 Browser Use ヘッドレスでのページ操作とスクレイピング

仕組み

gateway は、新しい設定フィールド use_gateway を使って、ツールごとに明示的に有効にする方式です。hermes auth に Portal の認証情報があり、かつ対象ツールで gateway を有効にしている場合、そのツールの呼び出しは Portal 経由で処理されます。それ以外の場合は、直接利用する API キーがあれば、そのキーが使われます。

# config.yaml — per-tool gateway opt-in
tools:
  web_search:
    provider: firecrawl
    use_gateway: true          # route via Nous Portal subscription
  image_generation:
    provider: fal
    use_gateway: true

実行時の優先順位: gateway が利用可能で、かつツールに use_gateway: true が設定されている場合、直接利用する API キーも設定されていても、Hermes は gateway を優先します。これは課金に関わる重要な点です。gateway の呼び出しで消費されるのは Portal サブスクリプションの利用枠であり、直接利用する API キーの残高ではありません。

gateway の有効化

hermes model                      # select Nous Portal (OAuth flow)
hermes tools                      # per-platform tool picker integrates gateway tools
hermes status                     # confirms gateway/subscription detection

サブスクリプションは、hermes auth に保存済みの Portal OAuth 認証情報から自動的に検出されるため、別途ログインする必要はありません。v0.19.0 以降は、セッション内でサブスクリプション自体も管理できます。/subscription ではプランと残りの利用枠を確認でき、アップグレードの正確な料金やダウングレードの適用時期を事前に確認したうえで変更を適用できます。変更予約を示すバナーや取り消し機能も用意されています。/topup ではクレジットを追加できます。デスクトップアプリにも、これに対応する請求設定タブがあります。70

料金と利用方法

料金とプラン名は、Nous Portal の料金ページ(https://portal.nousresearch.com/pricing)に掲載されています。このガイドではプランを列挙していません。プランは Hermes CLI ではなく Portal 製品側で管理され、Hermes のリリースとは独立して変更されるためです。https://portal.nousresearch.com/ で登録し、最新のプランは料金ページでご確認ください。

Nous の無料プランと初回起動ガイド(v0.21.2+)

v0.21.2 以降は、新規インストールしたエージェントを動かすために、有料プランや API キーを用意する必要がありません。無料の推論とコネクターが最初から利用でき、コマンド1つでサインインできます。チャット内からは /login でサインインを開始できます。コネクターのツール(Gmail、Linear、Notion など)も、ほかのツールと同様に tool_search で検索できます。デスクトップでは、HERMES_GUEST_ONBOARDING=1 によって初回起動ガイドが有効になります。有効になるのは値が厳密に 1 の場合だけです。デスクトップ側のテストでも、'true'、'0'、空の値ではいずれも無効のままであることを確認しています。また、起動時の判定結果は、起動されるバックエンドの環境変数に明示的に設定されるため、継承された値が意図せず反映されることはありません。48

v0.21.4 のリリース時期以降、これらのコネクターの接続処理は、各フロントエンドに分散したロジックではなく、バックエンドが一元的に管理する操作になっています。manage_connections ツールの呼び出しによって、バックエンド上でデータのみを扱う接続状態マシンが動作します(操作の制限時間は300秒固定で、意図的に設定キーにはしていません)。Desktop、TUI、CLI はいずれも、これを同じ設定カードとして表示します。カードには不足している認証情報ごとにフィールド(名前、入力案内、必須かどうか)が表示され、すべての必須フィールドにテキストが入力されるまで操作を実行できません。また、シークレットだけを分離して扱う同じルールを、バックエンドがすべてのフロントエンドに適用します。51

廃止に関するお知らせ

  • 環境変数 HERMES_ENABLE_NOUS_MANAGED_TOOLS は v0.10.0 で削除されました。マネージドツールは、ツールごとの設定フィールド use_gateway で有効にする方式に変わり、利用可否は Portal サブスクリプションの状態に応じて決まります。75

位置づけ:このリリースで変わらないこと

Hermes Agent CLI の利用にサブスクリプションは必要ありません。プロジェクトは引き続き MIT ライセンスで提供されており、すべてのコア機能(CLI、skill、メモリ、メッセージング gateway、cron、MCP、ローカルダッシュボード、全プロバイダーでの BYOK)は、誰にも料金を支払わずに一通り利用できます。v0.10.0 では、すでに Nous Portal を有料で利用しているユーザー向けに便利な選択肢が追加されました。無料で利用できる機能が削除されたわけではありません。


メッセージングgateway

Hermesは常駐するgatewayプロセスとして実行でき、1つのプロセスから28のメッセージングプラットフォームに接続できます。対象はTelegram、Discord、Slack、WhatsApp、Signal、SMS、Email、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、Weixin(WeChat)、BlueBubbles(iMessage)、QQBot、Microsoft Teams、Tencent Yuanbao、Google Chat、LINE、SimpleX Chat、Photon(iMessage)、WhatsApp Cloud API、WeCom Callback、Raft、IRC、ntfy、Buzz、汎用Webhookアダプターです。374171819 この28という数は、タグv2026.8.31のドキュメントにあるプラットフォーム比較表に基づきます。実装を見ると、gateway/config.pyには24個の組み込みPlatform列挙型メンバーが定義されています(local、api_server、webhook、msgraph_webhook、relayなど、チャット以外の項目も含まれます)。それ以外の名前は、必要に応じてplugins/platforms/内の22個の同梱アダプターディレクトリのいずれかに解決されるため、列挙型のメンバー数やディレクトリ数を単純に数えても、ドキュメントの数とは一致しません。25 v0.9.0では、BlueBubbles経由のiMessage対応(Webhookの自動登録、セットアップウィザード、クラッシュへの耐性)と、iLink Bot API経由のWeChatネイティブ対応が追加され、企業向けアプリ用のWeComコールバックモードも利用できるようになりました。16 v0.11.0ではQQBotが追加されました。74 v0.12.0ではMicrosoft TeamsとTencent Yuanbaoが追加されました。17 v0.13.0では20番目のプラットフォームとしてGoogle Chatが追加され、同じプラグイン式アダプターアーキテクチャを採用しています。IRCとMicrosoft Teamsも、汎用のenv_enablement_fn / cron_deliver_env_varプラグインフックを備えた新しいアダプターパターンに移行しました。18 v0.14.0ではLINEとSimpleX Chatが追加され、Microsoft Teamsのスタックも、Graph認証、Webhookリスナー、パイプラインランタイム、送信処理まで一通り完成しました。19 v0.17.0(2026年6月19日)では、Photon Spectrum経由で中継を必要としないiMessage対応が追加されました(hermes photon loginによるデバイスコードOAuthで、Mac/BlueBubblesによる中継は不要です)。さらに、公式WhatsApp Business Cloud APIアダプター(ブリッジプロセスが不要になります)、SimpleXのグループとネイティブ添付ファイルへの対応、同梱プラットフォームプラグインとしてのRaftも追加されました。21 ドキュメントの表には、リリースノートで大きく取り上げられていない2つのプラットフォームも載っています。ntfyは、HTTPのパブリッシュ/サブスクライブ方式を使った軽量なプッシュ通知チャネルです。ntfyモバイルアプリでトピックを購読し、そのトピックにメッセージを送るとエージェントと会話でき、返信がスマートフォンに届きます。公開サーバーのntfy.shでもセルフホストのインスタンスでも動作し、SDKやデーモンは必要ありません。Buzzは、Nostrプロトコル上で人とエージェントが協働するBlockのオープンソースプラットフォームで、HermesをBuzzコミュニティに接続します。送信時はbuzz CLIを外部プロセスとして呼び出し、受信時はネイティブのNostr WebSocketサブスクリプションを使います。どちらもhermes gateway setupから設定できます。25

セットアップ

hermes gateway setup                # Interactive platform configuration
hermes gateway install              # Install as user service (systemd/launchd)
hermes gateway start                # Start the installed service
hermes gateway stop
hermes gateway restart
hermes gateway status
hermes gateway run                  # Run in foreground (debugging)

対話形式のセットアップでは、APIトークン、ボットID、チャネルのマッピング、許可リストなど、各プラットフォームへの接続に必要な設定を順に進められます。6 v0.21.6以降、Discordの設定手順ではボットトークンを確認し、アダプターに必要な権限ビットを含む招待リンクを表示します。また、Message Content Intentが無効のままだとDiscordにボットの接続を拒否されるため、その状態も指摘します。5455

メッセージの流れ

開発元のアーキテクチャドキュメントでは、次のように説明されています。3

Platform event → Adapter.on_message() → MessageEvent
  → GatewayRunner._handle_message()
    → authorize user
    → resolve session key
    → create AIAgent with session history
    → AIAgent.run_conversation()
    → deliver response back through adapter

すべてのメッセージングプラットフォームは、CLIと同じAIAgentの会話ループを通ります。 そのため、スラッシュコマンドはどちらでも同じように動作し、Telegramでスケジュールしたcronジョブの出力をDiscordに届けることもできます。プラットフォームごとの差異は、接続部分にしかありません。3

v0.19.0では、profileに基づくメッセージルーティングと、永続化によって配信を保証する仕組みが追加されました。 1つのボットトークンを共有する多重化gatewayから、特定のギルド、チャネル、スレッドを別々のprofileに振り分けられます。各profileの設定、skill、メモリ、シークレットは完全に分離され、GATEWAY_MULTIPLEX_PROFILESによる上書きも可能です。また、一連の堅牢性の改善により、1つのprofileの設定ミスでgateway全体が停止することもなくなりました。内部ではルーティングインデックスがstate.dbに移され(sessions.jsonは任意の旧形式ミラーになりました)、プラットフォームへの送信処理の前後で、最終応答が配信義務を追跡する永続台帳に記録されます。回答が完成していてもgatewayのクラッシュで届かなかった場合は、黙って失われるのではなく、次回起動時に再配信されます。70 v0.21.2では、振り分け先のprofile間の分離が強化され、この多重化構成で発生していた一連のprofile間の漏洩が修正されました。対象は、許可リストの継承、デフォルトprofileのホストへの認証情報の送信、デフォルトprofileの保管庫にあるシークレットのstdio MCPサーバーへの流出、profileをまたぐMEDIA:添付ファイルの共有、別のprofileのNous bearerがプロセス単位のメモに残る問題です(#107609-#107630)。48

v0.21.1では、会話の区切りは明示的な操作でのみ作られるようになりました。 タグv2026.9.7のセッションライフサイクルに関するドキュメントでは、この仕様を4つの文で説明しています。「非アクティブな状態や実時間の経過によって会話が切り替わることはありません。/newと/resetは明示的な区切りを作り、長い履歴は引き続きコンテキスト圧縮で管理します。従来のタイマー設定は無視されます。既存のSessionResetPolicyデータ型は、互換性のために残された動作しないデータであり、実行時のポリシーではありません。」明示的に一時停止した場合は、引き続き次の受信ターンで区切りが作られます。復旧時も確定済みの区切りは維持され、再び開かれることはありません。また、リソース解放だけを目的とした退避では、会話を再開できる状態が保たれます。gatewayのセッションが「いつまでも期限切れにならない」ように見えるなら、それが現在の仕様です。切り替えるには、自分で/newを実行してください。43

v0.21.4のリリース時期以降、2つ目のhermes gateway runは、同じアドレスに重複してバインドするのではなく、既存のプロセスに接続するか、起動を拒否するようになりました。 原則として、ホスト上のOSユーザーごとにhermes serveとhermes gateway runをそれぞれ1つだけ実行し、各プロセスですべてのprofileを多重化します。実行中のマルチプレクサーがすでに処理しているprofileでgatewayを起動すると、そのプロセスに接続して終了コード0で終了します。まだそのprofileを処理していない場合、Hermesはprofiles/の再スキャンを要求し、処理対象になった時点で接続します。処理対象にできなければ、黙って2つ目のgatewayを起動することはせず、コマンドが起動を拒否します。--replaceは、どのprofileから起動されたかにかかわらず、そのホストプロセスを対象にするようになりました。所有プロセスが応答不能の場合、--forceを指定すれば確認を完全に省略できます。スタンドアロンのgatewayは引き続き共存可能です。実行中のgatewayが別のprofile専用のスタンドアロン(多重化しない)プロセスであれば、移行が必須になるまでは、従来どおり自分のprofile用のgatewayを並行して起動できます(#109417)。2つのgatewayが同時に起動した場合、ホストロックを取得できなかった側は終了コード75で終了します。Hermesが生成するすべてのスーパーバイザーは、この終了コードを受けて再試行します。その時点ではロックを取得した側のレコードが存在するため、再試行時は前述のルールに従って接続するか、起動を拒否します。ロックと接続先を特定するためのレコードは、OSユーザーごとの範囲で$HERMES_GATEWAY_LOCK_DIRに保存されます。未設定の場合は$XDG_STATE_HOME/hermes/gateway-locks(デフォルトは~/.local/state/hermes/gateway-locks)を使います。レコードのPIDに対応するプロセスが終了しているか、PIDが別のプロセスに再利用されている場合、そのレコードは古いものとして無視されます。そのため、gatewayがクラッシュしても次の起動を妨げません。Desktopアプリも同じルールに従い、2つ目のホストバックエンドを起動せず、実行中のものに接続します。51

v0.21.5以降、多重化は必須になりました。 gateway.multiplex_profilesで有効な値はtrueだけです。キーが未設定の場合は有効として扱われ、デフォルトprofileのconfig.yamlに書き込まれます。明示的にfalseが設定されている場合は、その場でtrueに書き換えられます。そのgatewayの起動時には枠付きの通知が1回表示され、次回のhermes updateの概要にも表示されます。従来の無効化オプションに代わり、2つの制御方法が用意されました。ほかのボットを停止せずに1つのprofileだけをオフラインにするには、hermes -p <name> gateway stopを実行します。ホストはそのprofileを休止状態にし(profiles/<name>/gateway.parkedマーカーを作成します)、hermes -p <name> gateway startで休止を解除します。ダッシュボードとDesktopの停止/開始ボタンも同じ動作です。名前付きprofileで引き続き専用のgatewayが必要な場合は、そのprofileのconfig.yamlにgateway.standalone: trueを設定します。ホストはそのprofileを処理せず、そのprofileのstop/startは専用プロセスを操作します。ドキュメントではこのキーを「一時的な互換性維持の仕組み」と位置づけており、サポートされる構成ではありません。また、デフォルトprofileでは警告とともに無視されます。OSユーザーを分ける場合や、デフォルトのホームディレクトリ内のprofiles/の外にHERMES_HOMEを置く場合は、引き続き--forceが必要です。53

ユーザーの認可とペアリング

hermes pairing list                    # Show pending and approved users
hermes pairing approve <platform> <code>
hermes pairing revoke <platform> <user-id>
hermes pairing clear-pending

ペアリングコードは、見知らぬ人が勝手にgatewayと会話するのを防ぎます。ユーザーがメッセージングプラットフォームからペアリングコードを送信し、管理者がhermes pairing approveで承認すると、そのユーザーは以後アクセスを許可されます。6

unauthorized_dm_behaviorは、ペアリング前に見知らぬ相手からDMを受け取った場合の動作を決めます。pairはペアリングコードをDMで送り、ignoreは返信せずにメッセージを破棄します。v0.21.4のリリース時期に追加されたdeclineは、丁寧な断りのメッセージを1回送った後、その送信者には24時間返信しません(#88028)。断りのメッセージはプラットフォームと送信者ごとに重複送信を防ぎ、エイリアスが異なっていても同じ送信者として扱います。文面はグローバルキーのunauthorized_dm_decline_messageから取得します。空の場合は、組み込みの返信「こんにちは!私は個人用アシスタントで、所有者としかチャットできないため、直接お手伝いすることはできません。申し訳ありません!」を使います。動作はグローバルに設定するか、セットアップウィザードが設定を書き込むプラットフォームごとの項目で指定してください。

# ~/.hermes/config.yaml
unauthorized_dm_behavior: decline      # global; gateway.unauthorized_dm_behavior also works
unauthorized_dm_decline_message: ""    # empty = built-in reply
platforms:
  telegram:
    unauthorized_dm_behavior: pair     # per-platform value always wins

何も設定していない場合、実際のデフォルト動作は許可リストによって変わります。許可リストが1つも設定されていなければpairです。いずれかの許可リスト(GATEWAY_ALLOWED_USERS、またはプラットフォームの許可ユーザー、グループの許可ユーザー、グループの許可チャットを指定する変数)が設定されると、ignoreになります。許可リストの設定はgatewayへのアクセスを意図的に制限していることを示すためです。未知の連絡先にコードを送ると不要な通知が増え、情報漏洩につながる可能性もあります(#9337)。グローバル設定のignoreまたはdeclineはこのルールより優先されますが、グローバル設定のpairはデフォルト値と区別されないため、優先されません。許可リストとペアリングを併用するには、プラットフォームごとにpairを設定してください。(プラットフォームアダプター独自のdm_policyが設定されている場合は、許可リストのルールより先に参照されます。)Emailは受信トレイを中心に動作するため、Email固有のプラットフォーム設定キーで明示的に有効にしない限り、デフォルトはignoreです。グローバル設定の値は適用されません。hermes gateway setupでは、許可リストなしでプラットフォームを設定する際に、選択肢の1つとしてdeclineが提示されます。51


スケジュールタスク(cron)

Hermesには、ジョブをシェルコマンドではなくエージェントのタスクとして扱う、本格的なcronシステムが組み込まれています。各スケジュールジョブは、新しいAIAgent上で設定済みのプロンプトと任意で追加したskillを使って実行され、任意のプラットフォームに結果を配信します。36

hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id>         # Trigger now on the next tick
hermes cron cancel <id>      # Stop an in-flight run (v0.22.6 window)
hermes cron remove <id>
hermes cron status           # Check if scheduler is running
hermes cron tick             # Run due jobs once and exit

メッセージアプリのチャット内で、会話を通じて作成することもできます。

Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

エージェントがツールを使ってcronジョブを設定します。ジョブはJSONに永続化され、再起動後も維持されます。3

実行漏れ(v0.22.6のリリース時期)。 マシンが停止していたりgatewayが止まっていたりした場合は、ジョブ自身のcatch_upが動作を決めます。trueでは逃したぶんをまとめて1回だけ補完実行し、falseでは次の実行枠まで飛ばします。このキーがないジョブは、繰り返しジョブであればcron.catch_up_missed(デフォルトはtrue)に従い、単発ジョブはオプトインしない限り120秒の猶予ルールを維持します。いずれの場合も、飛ばされた、または1つにまとめられた実行枠は、実行台帳に「missed xN」の1行として記録されるため、実行履歴には何も残らないのではなく、抜けがあったことが示されます。67

v0.21.0では、スケジュールジョブに記憶と判断の機能が加わりました。 次の4つの仕組みは、すべてタグv2026.8.31で検証済みです。3537

  • 継続性。 continuity=trueを指定すると、そのジョブ自身の直近の出力が毎回の実行時に注入されます。これにより、調査や監視を担うジョブは「前回の報告内容を見ながら起動し、重複を避けて前回の続きから再開」できます。注入時には「報告済みの内容を繰り返さない」という指示が添えられ、初回の実行は変わりません。内部では、このフラグはcontext_fromの予約済みエントリselfとして保存されます。hermes cron create ... --continuityとhermes cron edit <job_id> --continuity / --no-continuityで切り替えられます。37
  • 永続メモ帳。 各ジョブには、カーソル、処理済み位置、監視リストを保存する小さなKVメモ領域が用意されます(値ごとに16 KB、ジョブごとに64 KBです。毎回プロンプトに注入されるため、意図的に上限を設けています)。書き込みにはhermes cron notepad <job_id> set <key> <value>を使い、実行中のエージェントがターミナルツールを通じて呼び出します。37
  • 監視モード。 ジョブには、各実行タイミングで最初に動作する、低コストなmonitor_script/monitor_urlの情報源を追加できます。出力が変わっていなければ(バイト単位で完全一致を比較します)、エージェントの実行自体を抑止します。LLMの呼び出しも配信も行わず、通知のないno_change実行となります。変化があれば差分ブロックを注入し、通常どおりエージェントを実行します。監視スクリプトでは出力を安定させてください。そうしないと、実行のたびに変化があったと判定されます。37
  • ジョブごとの推論量とBot Chatへの配信。 --reasoning-effortはジョブの思考レベル(noneからultraまで)を固定し、そのジョブの実行では全体設定やモデルごとの設定より優先されます。また、deliver=bot-chatを指定すると、profileの標準Bot Chatセッションに出力が実際の受信メッセージとして届きます。人がチャンネルを読んで終わるのではなく、ボットが「対応が必要な内容に対処し、自分のチャットで応答」します。37

MCP連携

Hermesは、クライアントとサーバーの両方としてModel Context Protocolをサポートしています。6

クライアントとして — Hermesを外部のMCPサーバーに接続し、利用できるツールを拡張します。

hermes mcp add <name> --url https://example.com/mcp
hermes mcp add <name> --command npx --args "-y,@modelcontextprotocol/server-github"
hermes mcp list
hermes mcp test <name>
hermes mcp remove <name>
hermes mcp configure <name>   # Toggle individual tool selection
hermes mcp login <name>       # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all]     # Re-authenticate one OAuth server, or every one

config.yamlで手動設定することもできます。14

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

v0.19.0以降、MCPツールはmcp__server__toolという命名規則でモデルに公開されます。すべてのツール名にサーバー名が含まれるため、2つのサーバーが同名のツールを公開しても衝突しなくなりました。また、MCPサーバーのログ通知はagent.logに出力されます。70

v0.21.1では、MCPのOAuthにデバイスコードを使う認証経路が追加されました。hermes mcp login <name>で--flow {browser,device}を指定できます。browserは従来のPKCEフロー、deviceはヘッドレス環境やリモートマシン向けのRFC 8628に準拠したデバイスコードログインです。このフラグはサーバーのoauth.flow設定より優先されます。同時期の更新では、OAuthセッション全体でprofileの所有権が厳格に適用され、不正な形式のOAuthメタデータキャッシュはサーバーを動作不能にすることなく無視されるようになりました。また、デスクトップのMCPのOAuthは、クライアント側のローカルコールバックを介して中継されます。-t/--toolsetsは、設定済みのMCPサーバーのうち起動するものも絞り込むようになったため、対象を限定した呼び出しでは、不要なサーバーのコールドスタートを省略できます。44

v0.21.0では、デスクトップのMCP画面が一元管理の拠点になりました。サーバーとカタログを1つのページに統合し、ドラッグして取り込む「何でも貼り付け」インポート、ツール呼び出しが失敗する前に認証の有効期限切れが近いことを知らせるバックグラウンドのヘルスチェック、サーバーごとのスキーマの推定トークン数と30日間の使用状況を示すサーバー群全体のコスト・使用状況オーバーレイを備えています。また、hermes://ディープリンクから、明示的な確認を経てMCPサーバーをインストールできます。35

v0.21.4前後の更新では、mcp.discovery_concurrencyが追加されました(デフォルトは4、0は無制限、#117373)。これは、検出処理が設定済みのMCPサーバーに同時接続する数の上限です。すべてのサーバーへの接続は引き続き行われます。上限は、接続が一度に集中するのを防ぐだけです。整数以外や負の値を指定すると、警告がログに記録され、デフォルト値に戻ります。51

サーバーとして — Hermesの会話をほかのエージェントに公開します。

hermes mcp serve
hermes mcp serve -v    # Verbose

コンテキスト圧縮

Hermesは、モデルのコンテキストウィンドウに収まるよう、長い会話を自動的に圧縮します。圧縮用の要約処理は独立したLLM呼び出しで、任意のプロバイダーやエンドポイントを指定できます。4 v0.20.6以降、会話末尾の保持ポリシーはデフォルトでlean(compression.tail_mode: lean)となっています。このタグの時点では、要約処理のモデル・プロバイダー・エンドポイントの設定は、従来のcompression.summary_*ではなくauxiliary.compression.*配下にあります。旧キーは初回読み込み時に自動移行されます(設定バージョン17)。3031

compression:
  enabled: true
  threshold: 0.50          # Compress at this % of context limit
  threshold_tokens: null   # Optional absolute token cap -- trigger fires at the lower of ratio vs cap
  target_ratio: 0.20       # Fraction of threshold to preserve as recent tail (legacy tail mode)
  tail_mode: lean          # Tail retention: "lean" (default) or "legacy"
  protect_last_n: 20       # Min recent messages to keep uncompressed
  protect_first_n: 3       # Non-system head messages pinned across compactions
  prepare_ahead: false     # Opt in to preparing the summary in a background pass before compression runs (v0.22.6 window)

auxiliary:
  compression:
    model: ""              # Empty = main chat model; e.g. "google/gemini-3-flash-preview"
    provider: "auto"       # "auto", "openrouter", "nous", "codex", "main", etc.
    base_url: null         # Custom OpenAI-compatible endpoint (overrides provider)

tail_modeが決めること。 legacyは、target_ratioに応じた量の会話末尾を原文のまま保持します。コンテキストウィンドウが大きい設定や、圧縮しきい値を引き上げた設定では、圧縮のたびに100〜240Kトークンを抱え込むことになります。leanは、コンテキストウィンドウの2.5%に相当する末尾を原文のまま保持し、その量を下限10K、上限25Kに制限します。継続性は代わりに要約で確保します。要約には、圧縮した範囲の識別子を残した詳細なセッションログ(試行ごとに補助的な要約呼び出しを1回実行)、機械的に抽出したアンカー索引(PR番号、SHA、パス、エラー文字列を正規表現で抽出し、言い換えは行いません)、実際のユーザーメッセージすべての原文引用、そして要約で省略された内容にエージェントが再アクセスできるsession_searchの復元用ポインターが含まれます。ドキュメントに掲載された500Kトークンの実セッションでの測定結果では、保持量は約162Kから約49Kトークンに減少しました。leanで保持する末尾に含まれる古いツール結果は、復元用ポインター付きの1行の簡略表現に置き換えられます。未知のtail_mode値を指定した場合はleanにフォールバックします。31

プロバイダーの選択肢:431

auxiliary.compression.provider auxiliary.compression.base_url 動作
auto(デフォルト) 未設定 利用可能な最適なプロバイダーを自動検出します
nous / openrouter / など 未設定 指定したプロバイダーとその認証情報を使用します
任意 設定済み カスタムエンドポイントを直接使用します(プロバイダー指定は無視されます)

要約用モデルは、メインモデルと同等以上のコンテキスト長をサポートしている必要があります。会話の中間部分全体を1回の呼び出しで受け取るためです。ウィンドウがそれより小さいと呼び出しが失敗し、中間部分のターンは要約されないまま削除されます。431

実行回数の残りが少なくなったときの警告

多くのツール呼び出しを伴う複雑なタスクに取り組むと、エージェントは気づかないうちに反復回数の上限を使い切ることがあります(v0.20.0以降のデフォルトは500ターンで、従来の90ターンから増加しました)。上限が近づくと、モデルに自動で警告が送られます。4

しきい値 レベル モデルに表示される内容
70% 注意 [BUDGET: 350/500. 150 iterations left. Start consolidating.]
90% 警告 [BUDGET WARNING: 450/500. Only 50 left. Respond NOW.]

ストリームのタイムアウト

LLMのストリーミング接続には、ローカルプロバイダー(localhost、LAN IP)向けに自動調整される2段階のタイムアウトがあります。4

タイムアウト デフォルト ローカルプロバイダー 環境変数
ソケット読み取りタイムアウト 120秒 1800秒に自動延長 HERMES_STREAM_READ_TIMEOUT
ストリームの停滞検出 180秒 自動的に無効化 HERMES_STREAM_STALE_TIMEOUT
API呼び出し(非ストリーミング) 1800秒 変更なし HERMES_API_TIMEOUT

ローカルのLLMでは、大きなコンテキストのプリフィルに数分かかり、最初のトークンが生成されるまで待たされることがあります。そのため、ローカルエンドポイントのソケット読み取りタイムアウトは30分に延長されます。4


ローカルWebダッシュボード(v0.9.0以降)

Hermes Agentをローカルで管理するための、ブラウザーで使えるダッシュボードです。設定ファイルやターミナルを操作せずに、設定の変更、セッションの監視、skillの閲覧、gatewayの管理を行えます。16 hermes dashboardで起動します。GUIを好む新規ユーザーにとって、最も手軽に使い始められる方法です。

バックグラウンドプロセスの監視(v0.9.0+)

watch_patterns では、バックグラウンドプロセスの出力を監視するパターンを設定し、一致したときにリアルタイムで通知を受け取れます。16 エラーの監視、特定のイベント(「ポートでのリッスン開始」など)の待機、ビルドログの確認を、ポーリングなしで行えます。v0.8.0で導入された notify_on_complete(バックグラウンドタスクの完了を通知)と組み合わせることで、Hermesにはバックグラウンドプロセスの状態を把握するための一通りの仕組みが揃いました。15

差し替え可能なcontext engine(v0.9.0+)

hermes plugins を通じて、コンテキスト管理の仕組みを差し替えられるようになりました。独自のcontext engineを組み込めば、フィルタリング、要約、分野固有のコンテキストの注入などにより、各ターンでエージェントに何を見せるかを制御できます。16 コンテキストの管理方針がエージェントの中核ループから切り離されるため、プロジェクトや分野ごとにコンテキストをカスタマイズできます。

バックアップと復元(v0.9.0+)

hermes backup は、設定、セッション、skill、メモリをすべて含むアーカイブを作成します。hermes import では、バックアップアーカイブから復元できます。16 マシン間の移行、大きな変更を加える前のスナップショット作成、動作確認済みの設定のチーム内共有に活用してください。

Termux / Android対応(v0.9.0+)

Hermesは、Termuxを通じてAndroid上でネイティブに動作します。インストールパスの調整、モバイル画面向けのTUI最適化、音声バックエンドへの対応に加え、/image コマンドも端末上で利用できます。16

セキュリティの強化(v0.13.0+)

v0.13.0では、P0のセキュリティ問題8件を解消し、デフォルト設定を1つ、ユーザーにとって有利な方向へ変更しました。18 続くv0.14.0では、さらにP0を12件、P1を50件解消しています。sudoのブルートフォース攻撃対策とsudo-stdinの保護強化、危険なコマンドの制限回避への修正、モデルに再注入する前のツールエラーのサニタイズ、ダッシュボードのプラグインAPI認証、skills-hubのSSRF対策、インストール時のサプライチェーン関連のセキュリティ勧告のスキャンなどが含まれます。19

修正 変更内容
機密情報のマスキングをデフォルトで有効化 以前は明示的な有効化が必要でした。現在は明示的に無効化しない限り、ログと hermes debug share のアップロード内容から機密情報をマスキングします。v0.12.0ではペイロードの破損報告を受けてデフォルトで無効化されていましたが、v0.13.0では安全性を優先した標準設定として再び有効になりました。
DiscordのギルドをまたぐDM制限の回避(CVSS 8.1) Discordのロール許可リストがギルド単位になりました。これにより、1つのギルドでのユーザーロールによって、すべてのギルドにまたがってDMが許可されてしまう経路を塞いでいます。
WhatsAppのデフォルトの制限 WhatsAppアダプターはデフォルトで見知らぬ相手を拒否し、自分とのチャットには一切応答しません。
MCP OAuthのTOCTOUの隙間 MCP OAuthフローで認証情報を保存する際の競合状態を解消しました。
CLIの auth.json におけるTOCTOU CLIの認証ストアに認証情報を書き込む処理でも、同様のTOCTOUの隙間を解消しました。
ブラウザーのSSRF対策の最低基準 ハイブリッドルーティングでは、169.254.169.254 などのクラウドメタデータへのアクセスを試みるリクエストに対し、最低限のSSRF防御を必ず適用します。
cronのプロンプトインジェクション検査 cronジョブの実行前に、組み立て済みのプロンプト(読み込まれたskillの内容を含む)にプロンプトインジェクションがないか検査します。
hermes debug share のマスキング デバッグ情報の共有アップロードでは、ログの書き込み時だけでなく、アップロード時にもログ内容をマスキングします。

Hermesの運用を担当している場合、v0.13.0とv0.14.0は、単なる機能追加ではなく、セキュリティに関わるアップグレードとして扱ってください。v0.13.0では、Discordのギルドをまたぐ制限回避と2つのTOCTOUの隙間を解消しています。v0.14.0では、sudoの処理、ツールエラーの再注入、プラグインAPI、skills-hubのSSRF、依存関係のセキュリティ勧告にわたり、さらに保護を強化しています。

v0.21.0では第4弾の強化が加わりました。 保護対象のエージェント指示ファイル – AGENTS.md、CLAUDE.md、SOUL.md、.cursorrules、skill、メモリストア – への書き込みには、常に承認が必要になりました。これにより、プロンプトインジェクションを受けたエージェントが、自身の常設の指示をひそかに書き換えることを防ぎます。この承認チェックはデフォルトで有効です(security.protected_instruction_files: true。protected_instruction_extra_patterns には、fnmatch でベース名を照合して保護対象を追加するリストを指定できます)。出典では、防ぐ対象を「AGENTS.md / CLAUDE.md / SOUL.mdを編集する、注入された指示」と明示しています。また、指示ファイルはcwdのディレクトリツリーから読み込まれるため、「エージェントが後で実行される可能性のある場所にあるAGENTS.mdは、どれも攻撃対象になり得る」と説明しています。3539 同じリリースでは、ターミナルエラー、.env ファイルの読み取り、checkpoint、ACPログにおける機密情報漏えいの隙間も解消しています。さらに、承認システムがWindowsの破壊的なコマンドとパスを認識できるようになり、固定のTCC署名IDによってmacOSの権限付与がアップデート後も維持されるようになりました(初回のみの設定:hermes desktop --setup-tcc-identity。macOS専用で、openssl/security/codesignが必要です)。上流での侵害を受けてBlender MCPのカタログ項目とskillを削除し、プラグインのインストールにはTier-1のセキュリティスキャンを追加しています。3539

v0.21.6では第5弾が加わりました。 Tenable Researchが報告したダッシュボード認証の問題4件を修正しています(X-Forwarded-For の偽装によるログイン試行回数制限の回避、未認証リクエストによる認証監査ログへの無制限の書き込み、公開 /auth/ ルートでの本文サイズ制限の欠如、セッションの乗っ取りにつながるループバック以外のリダイレクト先へのログインコード送信)。また、自動的なgit呼び出しでは、最初のプロンプトより前に、信頼できないリポジトリが独自に指定する clean、smudge、process フィルタープログラムを実行しなくなりました。メールの From ヘッダーは parseaddr で解析するようになり、引用符で囲まれた表示名によって許可リストの判定をすり抜けることも防ぎます。詳細はv0.21.6の新機能をご覧ください。5455


実践者向けのアーキテクチャ

このセクションでは、デバッグや拡張、パフォーマンスの検討に役立つよう、内部の仕組みを解説します。上流のアーキテクチャドキュメントをまとめた内容です。3

エントリーポイント → AIAgent

Hermesのすべてのエントリーポイントは、最終的にAIAgent.run_conversation()を呼び出します。

┌──────────────────────────────────────────────────────────────────┐
│                        Entry Points                              │
│                                                                  │
│  CLI (cli.py)    Gateway (gateway/run.py)    ACP (acp_adapter/)  │
│  Batch Runner    API Server                  Python Library     │
└──────────┬──────────────┬───────────────────────┬────────────────┘
           │              │                       │
           ▼              ▼                       ▼
┌──────────────────────────────────────────────────────────────────┐
│                     AIAgent (run_agent.py)                       │
│                                                                  │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐             │
│  │ Prompt      │  │ Provider     │  │ Tool         │             │
│  │ Builder     │  │ Resolution   │  │ Dispatch     │             │
│  └──────┬──────┘  └──────┬───────┘  └──────┬───────┘             │
│         │                │                 │                    │
│  ┌──────┴───────┐ ┌──────┴───────┐  ┌──────┴───────┐             │
│  │ Compression  │ │ 3 API Modes  │  │ Tool Registry│             │
│  │ & Caching    │ │ chat_compl   │  │ 47 tools     │             │
│  │              │ │ codex_resp   │  │ 20 toolsets  │             │
│  │              │ │ anthropic    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

上流のアーキテクチャドキュメントをもとに作成した図です。3

「47ツール / 20 toolset」と起動バナーの「28ツール」の違い。 「47ツール」は、上流リポジトリのツールレジストリ全体の数です。すべてのtoolsetにわたり、Hermesがソースコードを同梱しているツールを合計しています。実際に実行中のCLIでは、起動バナーにこれより少ない数が表示されます(このガイドの検証に使った環境では28 tools / 89 skillsと表示されます)。これはバグではありません。メッセージングプラットフォームのアダプター、ブラウザー自動化、負荷の高いスクレイピングツールなど、多くのtoolsetはオプトイン方式で、config.yamlのtoolsets:で明示的に有効にする必要があります。レジストリの合計は「利用可能なもの」、バナーの数は「現在のprofileで有効なもの」を表します。有効なtoolsetはhermes tools --listで確認でき、個別の有効化・無効化は~/.hermes/config.yamlのtoolsets:ブロックで設定できます。実行中のセッション内では、/tools list / /tools enable <name> / /tools disable <name>も使えます。ツールを削除するとセッションがリセットされ、エージェントがツールマニフェストを再構築します。

3つのAPIモード

Hermesはプロバイダー間の違いを3つのAPIモードに抽象化し、実行時に自動で選択します。3

APIモード 使用するプロバイダーなど
chat_completions OpenRouter、z.ai、Kimi、MiniMax、DeepSeek、Alibaba、ほとんどのカスタムエンドポイント、すべてのOpenAI互換サーバー
codex_responses OpenAI Codex(ChatGPT OAuth経由)
anthropic_messages Anthropic API(ネイティブ)、Anthropic OAuth、Anthropic互換プロキシ

runtime_provider.pyのリゾルバーは、18以上のプロバイダーについて、(provider, model)のタプルを(api_mode, api_key, base_url)に対応付けます。OAuthフロー、認証情報プール、エイリアスの解決も処理します。3

CLIセッションのデータフロー

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → agent.prompt_builder.build_system_prompt()
    → runtime_provider.resolve_runtime_provider()
    → API call (chat_completions / codex_responses / anthropic_messages)
    → tool_calls? → model_tools.handle_function_call() → loop
    → final response → display → save to SessionDB

上流のアーキテクチャページより。3

プロンプトの組み立て順序

プロンプトは、次の要素で構成されます。13

  1. SOUL.md(エージェントのアイデンティティ。利用できない場合は組み込みの代替設定)
  2. ツールを考慮した動作指針
  3. メモリとユーザーのコンテキスト(MEMORY.md、USER.md)
  4. skillの利用指針
  5. コンテキストファイル(AGENTS.md、.cursorrules)
  6. タイムスタンプ
  7. プラットフォーム固有の書式設定ヒント
  8. /personalityなど、任意で追加するシステムプロンプトのオーバーレイ

SOUL.mdが土台となり、その上にほかのすべての要素が積み重なります。13

セッションストレージ

セッションストレージはSQLiteベースで、FTS5による全文検索に対応しています。セッションには、圧縮前後の親子関係を追跡する機能、プラットフォームごとの分離、競合処理を備えたアトミックな書き込みが用意されています。3

v0.21.x環境でストレージに問題が起きる場合は、v0.21.2以降を使用してください。このバージョンでは、v0.21.0当時のstate.dbにまつわる一連の問題(複数の書き込み処理が互いのロックを解除する、正常なデータベースが破損と判定される、不正な行が1つあるだけでsessions listが失敗する)が解消されました。また、ホスト型ルームの調整処理をルートストレージから専用のshared-state.dbへ移したため、各profileのgatewayがマスターセッションストレージを書き込み可能な状態で開くことはなくなりました。hermes doctorは構造の破損とFTSインデックスの破損を区別して報告し、FTSの破損はターンを失敗させず、検索機能の低下にとどまります。さらに、hermes sessions recover --inspect-only(オフライン・非破壊・対象profile固定)は、出力データベースを作成せずに正規テーブルが読み取り可能かどうかを報告します。このサブコマンド自体はこのリリース期間より前から存在していましたが、ここでは未記載でした。v0.21.2の新機能をご覧ください。48 SQLiteのジャーナルモードが誤った状態から戻せない場合に備え、v0.21.4のリリース期間にはオフライン変換コマンドhermes sessions set-journal-mode delete|walが追加されました(トップレベルコマンドのhermes sessions行を参照)。51

プラグインシステム

プラグインの検出元は、~/.hermes/plugins/(ユーザー)、.hermes/plugins/(プロジェクト)、pipのエントリーポイントの3つです。プラグインはコンテキストAPIを通じて、ツール、フック、CLIコマンドを登録します。メモリプロバイダーは、plugins/memory/配下に置く専用のプラグイン種別です。3 v0.21.6以降では、plugins.isolation: host(デフォルトはin_process)により、サードパーティのPythonプラグインコードをHermesプロセスの外で実行できます。一般のプラグインはprofileごとに1つのプラグインホストプロセスに読み込まれ、ctxを通じてのみHermesと通信します。ユーザーコードをプロセス内にインポートするほかの経路(カテゴリープロバイダー、モデルプロバイダーのprofile、ダッシュボードのプラグインAPI)は、理由を明示して拒否されます。同梱プラグインは引き続きプロセス内で動作します。このため、プラグインがハングまたはクラッシュしても、停止するのはそのホストであり、gatewayには波及しません。55 v0.21.2以降では、厳選され、SHAで固定されたプラグインカタログも利用でき、名前で探してインストールできます。また、「宣言的で共有可能なプラグインセット」のためにhermes plugins packも用意されています。1つのhermes-pack.yamlで複数のプラグインを正確なコミットSHAに固定し、packのインストール時には通常の固定バージョンのインストールが個別に実行されます。機能の利用に対する同意は、引き続きプラグインごとに行います。48

v0.21.4のリリース期間には、このカタログがCLIから利用する機能から、配布物として整備されました。リポジトリのplugin-catalog/ディレクトリは、v2026.9.14時点の9件からv2026.9.21時点の228件に増えています。プラグインごとにレビュー済みのYAMLが1つあり、名前、リポジトリ、メンテナー、ティア、カテゴリー、機能を記載し、正確な40文字のコミットSHAに固定しています。このディレクトリに存在することが、カタログへの登録承認を意味します。カタログはCLI向けにplugin-catalog.jsonとして公開され、利用時に取得されて~/.hermes/cache/にキャッシュされます。ドキュメントサイトでは、同じデータからプラグインごとのページ(/docs/plugins/<name>)と作者ごとのページ(/docs/plugins/by/<slug>)を生成するようになりました。各ページに表示するプラグインのREADMEは、ブランチの先端ではなく、必ず固定されたコミットから取得します。ビルド時の許可リストで生のHTMLを除去し、追加日・更新日での並べ替えにはコミッター日時を使います。v0.21.4のリリースで紹介された10個のコミュニティプラグインは、すべてそのタグ時点のカタログに、実際のカタログスラッグで登録されています。hermes-tailscale、hermes-ssh、shodan、hermes-terminal、hermes-rss(別途rss-readerもあります)、hermes-resetwatch、done-bell、kiwi、cognee、web-octenです。デスクトップでは、Pluginsハブから確認ダイアログを経てプラグインをアンインストールできるようになりました。カタログのプラグインはplugins.manage removeを通じて、スタンドアロンのデスクトッププラグインはElectronローダーを通じて削除されます。51

hermes plugins                       # Interactive enable/disable UI
hermes plugins browse                # List every curated plugin catalog entry (v0.21.2+)
hermes plugins search <query>        # Search the curated plugin catalog (v0.21.2+)
hermes plugins install <name|repo>   # Install from the curated catalog, a Git URL, or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list
hermes plugins pack install <src>    # Shareable SHA-pinned plugin sets; also: pack export, pack show (v0.21.2+)

互換期間(v0.21.1)は終了しています。外部プラグインは、2026年9月14日までに分割前のインポートパスから移行する必要がありました。 2026年9月の分割(PR #102117)では、プラグインがよくインポートしていた内部実装が移動しました。一時的なCOMPAT_MANIFEST.mdレイヤーが、移動した1,148個の公開名を旧モジュールから再エクスポートし、プロセスごとに各名前について1回ずつ警告(HermesPluginCompatWarning)を出していました。廃止は予定どおり2026年9月14日に適用されました。 配布済みコードの日付判定(hermes_cli/plugin_compat.py内のCOMPAT_REMOVAL_DATE)によるもので、コードを差し戻す必要はありませんでした。この日以降、該当するプラグインは無効化され、読み込まれません。CLIのバナー、hermes doctor、hermes updateに赤い通知が表示され、デスクトップではモーダルが1回表示されます。理由はhermes plugins listで確認できます。プラグイン作者向けには、hermes plugins compat <path>が引き続き、該当するすべてのfile:lineと旧パス → 新パスを出力し、1件でも残っていれば終了コード1を返します(機械可読の出力には--jsonを追加してください)。保守されていないプラグインを使い続ける必要がある場合は、config.yamlにplugins.allow_deprecated_imports: trueを設定できます。値はYAMLの真偽値リテラルである必要があり、引用符で囲んだ文字列は使えません。この設定がまだ機能するのは、旧パスを削除する差し戻しがまだ取り込まれていないためです。マニフェストと互換シムは、v2026.9.14、v2026.9.21、v2026.9.24、そして9月24日時点のmainに残っています(v0.21.4のリリース期間に互換モジュールへ加えられた変更は、プラグインスキャンのキャッシュとWindowsパスの正規化のみです。v0.21.5のリリース期間ではhermes_cli/plugin_compat.pyは変更されず、削除されたHindsightモジュールのマニフェストエントリーだけが取り除かれました)。その差し戻しが取り込まれた時点で旧パス自体がなくなるため、この回避策は機能しなくなります。対象は公開されたトップレベルの名前だけです。非公開の名前やテスト用のモンキーパッチ箇所は、もともと互換性の保証対象ではなく、復元されません。4253 v0.21.6では、この回避策は使えなくなりました。 マニフェスト、互換シム、hermes plugins compatスキャナー、plugins.allow_deprecated_importsは削除されました。hermes_cli/plugin_compat.pyは、古いチェックアウトから動作中のアップデーターのために、何もしないスタブとして残されています。分割前のパスをまだインポートしているプラグインは、インポートに失敗します。55

設計原則

上流のアーキテクチャページより。3

原則 実際の動作
プロンプトの安定性 会話の途中でシステムプロンプトは変わりません。ユーザーの明示的な操作(/model)を除き、キャッシュを無効にする変更は行いません
実行状況の可視性 すべてのツール呼び出しが、コールバックを通じてユーザーに表示されます。CLIではスピナー、gatewayではチャットメッセージで進捗を伝えます
中断可能 API呼び出しやツールの実行は、ユーザー入力やシグナルによって途中でキャンセルできます
プラットフォームに依存しないコア 1つのAIAgentクラスが、CLI、gateway、ACP、バッチ、APIサーバーに対応します。プラットフォーム間の違いはエントリーポイントで扱います
疎結合 任意のサブシステム(MCP、プラグイン、メモリプロバイダー、RL環境)は、必須の依存関係にせず、レジストリパターンとcheck_fnによる有効化判定を使います
profileの分離 各profileが独自のHERMES_HOME、設定、メモリ、セッション、gatewayのPIDを持ちます。複数のprofileを同時に実行できます

OpenClawからの移行

Hermes AgentはOpenClawの後継です。既存のOpenClaw環境から移行する場合は、次のコマンドを実行します。65

hermes claw migrate --dry-run                    # Preview what would be migrated
hermes claw migrate --preset full                # Full migration including API keys
hermes claw migrate --preset user-data --overwrite   # User data only, no secrets
hermes claw migrate --source /custom/path        # Non-default OpenClaw location

hermes claw migrateは、デフォルトで~/.openclawから読み込み(旧ディレクトリの~/.clawdbotと~/.moldbotも自動検出します)、~/.hermesに書き込みます。6

直接インポートされる項目(30以上のカテゴリ):SOUL.md、MEMORY.md、USER.md、AGENTS.md、4つのソースディレクトリにあるskill、デフォルトモデル、カスタムプロバイダー、MCPサーバー、メッセージングプラットフォームのトークンと許可リスト(Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost)、エージェントのデフォルト設定(推論の強度、圧縮、人間らしい応答遅延、タイムゾーン、サンドボックス)、セッションのリセットポリシー(現在は無効です。v0.21.1以降、タイマーによって会話が切り替わることはありません43)、承認ルール、TTS設定、ブラウザー設定、ツール設定、実行タイムアウト、コマンド許可リスト、gateway設定、3つのソースから取得したAPIキーです。6

手動確認用にアーカイブされる項目: cronジョブ、プラグイン、フック/Webhook、メモリバックエンド(QMD)、skillレジストリ設定、UI/アイデンティティ、ログ設定、マルチエージェント設定、チャンネルの関連付け、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.mdです。6

APIキーの解決時には、設定値 → ~/.openclaw/.env → auth-profiles.jsonの優先順で3つのソースを確認します。6


トラブルシューティング

「推論プロバイダーが設定されていません。’hermes model’を実行してプロバイダーとモデルを選択してください」

新規インストールで最初に遭遇するエラーです。Hermesで使用するプロバイダーがまだ確定していません。メッセージのとおり、3つある認証経路のいずれからも、利用可能なプロバイダーを取得できていない状態です。次のコマンドを実行してください。

hermes model

対話式の選択画面では、OAuthのデバイスコードフロー(Nous Portal、GitHub Copilot、Anthropic、OpenAI Codex)やセルフホストサーバー用のカスタムエンドポイントを含め、対応するすべてのプロバイダーを設定できます。プロバイダーは設定済みのはずだと思う場合は、hermes doctorでHermesが実際に認識している認証情報を確認してください。よくある原因は、APIキーの設定場所の誤り(シェルのprofileではなく、.envまたはhermes config setで設定します)、~/.hermes/auth.json内のOAuth認証情報の期限切れ、config.yaml内のカスタムエンドポイントからのbase_urlの欠落です。認証経路については、認証とプロバイダーで詳しく説明しています。27

「APIキーが設定されていません」

hermes modelを実行して対話式でプロバイダーを設定するか、hermes config set OPENROUTER_API_KEY your_keyを実行してください。hermes doctorコマンドで、不足しているキーを正確に確認できます。7

起動時に「コンテキスト上限:2048トークン」と表示される(ローカルモデル)

Hermesはサーバーの/v1/modelsエンドポイントからコンテキスト長を自動検出しますが、多くのローカルサーバーは小さなデフォルト値を返します。config.yamlで明示的に設定してください。2

model:
  default: your-model
  provider: custom
  base_url: http://localhost:11434/v1
  context_length: 32768

ツール呼び出しが実行されず、テキストとして表示される

サーバーでツール呼び出しが有効になっていないか、サーバー側の実装ではそのモデルのツール呼び出しに対応していません。2

サーバー 対処方法
llama.cpp 起動コマンドに--jinjaを追加します
vLLM --enable-auto-tool-choice --tool-call-parser hermesを追加します
SGLang --tool-call-parser qwen(または適切なパーサー)を追加します
Ollama ツール呼び出しはデフォルトで有効です。ollama show <model>でモデルが対応しているか確認してください
LM Studio 0.3.6以降に更新し、ツールをネイティブにサポートするモデルを使用します

応答が文の途中で途切れる

考えられる原因は2つあります。2

  1. サーバー側の出力上限(max_tokens)が低い — SGLangでは、デフォルトで1回の応答が128トークンに制限されています。サーバー側で--default-max-tokensを設定するか、config.yamlでmodel.max_tokensを設定してください。
  2. コンテキストの容量不足 — モデルのコンテキストウィンドウがいっぱいになっています。model.context_lengthを増やすか、Hermesのコンテキスト圧縮を有効にしてください。

WSL2からWindows上のモデルサーバーに接続すると「接続が拒否されました」と表示される

WSL2は独自のサブネットを持つ仮想ネットワークアダプターを使用します。そのため、WSL2内のlocalhostはWindowsホストではなく、Linux仮想マシンを指します。対処方法は2つあります。2

ミラーネットワーク(Windows 11 22H2以降):%USERPROFILE%\.wslconfigを編集します。

[wsl2]
networkingMode=mirrored

続いてwsl --shutdownを実行し、WSLを再起動します。これでlocalhostが双方向で使えるようになります。

ホストIPを使う代替方法(古いWindows):WSL2内からWindowsホストのIPを取得し、localhostの代わりに使用します。

ip route show | grep -i default | awk '{ print $3 }'
# Use that IP as the base_url host

また、モデルサーバーのバインド先を127.0.0.1ではなく0.0.0.0にする必要があります。OllamaではOLLAMA_HOST=0.0.0.0を設定し、llama-server/SGLangでは--host 0.0.0.0を追加します。LM Studioでは「Serve on Network」を有効にしてください。2

反復回数の上限にagent.max_turnsが反映されない

config.yamlではagent.max_turns: 500と設定しているのに、アクティビティ行にN/90(または別の古い上限)が表示される場合は、~/.hermes/.envに古いHERMES_MAX_ITERATIONSの行が残っている可能性があります。以前のセットアップウィザードは、両方の保存先に上限を書き込んでいました。起動時の設定連携処理が、それ以前の設定解析エラーによって中断されると、.envに残った値が通知なく優先されてしまいます。v0.21.1以降では、hermes doctorがこの設定の重複と上書きを検出し、hermes doctor --fixで.envの該当行を削除できます。以降はconfig.yamlの設定が優先されます。41

必要な情報やファイルはどこにある?

こうしたときに役立つのがhermes statusとhermes dumpです。hermes logs listは、すべてのログファイルをサイズ付きで表示します。hermes config pathは設定ファイルの場所を、hermes config env-pathは.envの場所を表示します。6


よくある質問

Hermes AgentとClaude Codeの違いは何ですか?

Claude CodeはAnthropicの公式CLIで、Anthropicのモデルのみを利用できます。Hermes AgentはNous Researchが開発するオープンソースのエージェントフレームワークで、OpenAI互換のプロバイダーであれば、Nous Portal、OpenRouter、Anthropic、GitHub Copilot、z.ai、Kimi、MiniMax、DeepSeek、Hugging Face、Google、独自にホストするエンドポイントなど、どれでも利用できます。12 また、HermesにはTelegram/Discord/Slack/WhatsApp/Signal向けのメッセージングgatewayが付属しており、これはClaude Codeにはない機能です。

AnthropicのAPIキーでHermesを使えますか?

はい。次の3つの方法があります。2

  1. ~/.hermes/.envにANTHROPIC_API_KEYを設定し、hermes chat --provider anthropic --model claude-sonnet-4-6を実行します
  2. hermes modelを実行してAnthropicを選択します。Claude Codeの認証情報ストアが利用可能であれば、Hermesがそれを使用します
  3. フォールバックとしてANTHROPIC_TOKEN(setup-tokenまたはOAuthトークン)を手動で設定します

同じマシンですでにClaude Codeを使っている場合は、方法2をおすすめします。更新可能なClaude認証情報を、そのまま更新可能な状態で利用できます。

会話を失わずにプロバイダーを切り替えるにはどうすればよいですか?

セッション内で/model provider:modelを使います。会話履歴、メモリ、skillはすべて引き継がれます。9

/model zai:glm-5
/model openrouter:anthropic/claude-sonnet-4
/model custom:local:qwen-2.5

Anthropicを設定しましたが、画像認識・Web・圧縮が動作しません

現在のビルドでは、以前と同じ原因でこの問題が起きることはほとんどありません。デフォルト(auxiliary.*.provider: "auto")では、画像認識、承認の分類、圧縮、セッションタイトルの生成といった補助タスクがすべてメインのチャットモデルで実行されます。そのため、Anthropicのみを設定した環境でも、すでに利用しているOAuthで処理できます。以前のデフォルト動作(OpenRouter経由のGemini Flash → Nous → Codexの順に自動検出し、どれも未設定の場合は通知せずに機能が低下する仕組み)は廃止されました。「現在、autoはすべてのユーザーでメインモデルを使用し、config.yamlのタスク別設定が引き続き優先されます。」34

それでも補助タスクが失敗する場合は、未設定のプロバイダーを明示的に指定しているタスク別設定(config.yamlのauxiliary.<task>.provider / .model)、または古い設定キーが残っていないか確認してください。タグv2026.8.31以降、圧縮用の要約モデルはほかの補助タスクと同じようにauxiliary.compression.providerで設定します。従来のcompression.summary_*キーは、この設定へ自動的に移行されます(設定バージョン17)。31 Web抽出はもはやLLMのタスクではありません(「LLMは関与しません」)。そのため、現在のビルドでWeb要約が失敗しても、補助モデルの問題ではありません。34 タスクの実行先を明示的にメインのプロバイダーへ戻すには、次のように設定します。

auxiliary:
  vision:      { provider: "main" }
  compression: { provider: "main" }

SOUL.mdとAGENTS.mdの違いは何ですか?

SOUL.mdはエージェントの個性を定義するファイルで、口調、文体、コミュニケーションの基本方針を記述します。~/.hermes/SOUL.mdに配置し、どこでも適用されます。AGENTS.mdはプロジェクト固有のファイルで、アーキテクチャ、規約、コマンド、パスを記述し、プロジェクトディレクトリに配置します。13 どこでも適用したい内容はSOUL.mdに、プロジェクトに属する内容はAGENTS.mdに記述してください。

複数のHermesインスタンスを並行して実行するにはどうすればよいですか?

profileを使います。各profileには、専用のHERMES_HOME、設定、メモリ、セッション、gatewayのPIDが割り当てられます。6

hermes profile create work --clone
hermes profile use work                 # Sticky default
hermes -p work chat -q "..."            # One-off without switching
hermes profile alias work --name h-work # Wrapper script

HermesはローカルのLLMに対応していますか?

はい。カスタムエンドポイントを使うことで対応できます。Hermesは、Ollama、vLLM、SGLang、llama.cpp/llama-server、LM Studio、LocalAI、Jan、独自のサーバーなど、あらゆるOpenAI互換サーバーで動作します。2 サーバーごとの設定方法は、カスタムエンドポイントとセルフホスト型エンドポイントをご覧ください。

起動時のバナーに表示されるツール数が、このガイドに記載された数より少ないのはなぜですか?

このガイドに記載している47個のツールと20個のtoolsetは、開発元のアーキテクチャレジストリに基づく数です。これは、すべてのtoolsetにわたってHermesがソースコードを提供しているツールの総数を表します。実際の環境でバナーに表示される数が少ないのは(このガイドの参照環境では28個)、起動時にデフォルトのtoolset群だけが有効になるためです。多くのtoolsetは明示的に有効化する必要があります。メッセージングgatewayアダプター、ブラウザー自動化、負荷の大きいスクレイピング基盤、各種の専門的な連携機能は、~/.hermes/config.yamlのtoolsets:に明示的に指定しないと読み込まれません。レジストリの総数は「有効にすれば使えるもの」、バナーの総数は「現在のprofileで実際に読み込まれたもの」です。hermes tools --listを使うと、有効なtoolsetと、利用可能でも無効になっているtoolsetを確認できます。実行中に個々のtoolsetを切り替えるには、/tools enable <name>と/tools disable <name>を使います(無効化するとセッションがリセットされ、エージェントが変更後の構成でツールマニフェストを再構築します)。

プライマリプロバイダーに障害が起きた場合、Hermesはどのようにモデルをフォールバックしますか?

config.yamlにfallback_modelブロックを設定します。2

fallback_model:
  provider: openrouter
  model: anthropic/claude-sonnet-4

プライマリに障害が起きると(レート制限、サーバーエラー、認証失敗)、Hermesは会話履歴を保持したまま、セッションの途中でフォールバック先に切り替えます。切り替えは1セッションにつき最大1回です。

エージェントは使い続けるうちに自分のskillを改善できますか?

はい。これがHermes Agentの「自己改善」に当たる部分です。エージェントはskill_manageツールでskillを作成、更新、削除できます。複雑なワークフローを解決すると、その手順をskillとして保存し、後で再利用します。11 skillが作成されるのは、複雑なタスク(5回以上のツール呼び出し)を終えたとき、エラーに遭遇して動作する方法を見つけたとき、ユーザーが進め方を修正したとき、あるいは複雑なワークフローを発見したときです。

IDEとの連携機能はありますか?

はい。HermesはVS Code、Zed、JetBrains向けのACP(Agent Client Protocol)サーバーとして実行できます。6

pip install -e '.[acp]'
hermes acp

変更履歴

日付 変更内容 出典
2026年11月2日 ガイド v1.30:Hermes v0.22.6(タグv0.22.6、11月2日)――4回目の小規模な累積リリースです。v0.22.5以降の約776件のPRをまとめ、整理されたリリースノートは引き続きv0.23.0に持ち越されています。 冒頭に新機能セクションを追加し、リリース自身が挙げる一覧をタグ時点で検証して掲載しました。要約からも案内しています。タグ時点のツリー全体をv0.22.5と比較して検証しました(追加1,504、削除237、変更2,646)。カタログは763件から911件、プラットフォームは27件、モデルプロバイダープラグインは41件から39件になりました。これはGitHub Copilotが10月25日にコアを離れ、github-copilot labsプラグインになったためです(リリースノートには記載がなく、Copilotを利用していたprofileにはhermes updateがこのプラグインをインストールします)。新たにconfig_backends/remoteとConfigBackend接合層が加わり、メモリプロバイダー、ロケール、互換性スタブは変わりません。本文では、Copilotのセクションと対応表の行、/model reset、hermes webappとhermes vaultの行、hermes cron cancelと実行漏れのポリシー、hermes migrate <agent>(Grok Bot、OpenBot)、curatorのlockとunlock、compression.prepare_ahead、ElevenLabsのvoice_idとfind_voicesを更新しました。 6667
2026年10月23日 ガイド v1.29:Hermes v0.22.3(10月21日)、v0.22.4(10月21日)、v0.22.5(10月22日、10月23日公開)――3つの小規模な累積リリースです。整理されたリリースノートはv0.23.0に付属します。 冒頭に新機能セクションを追加し、各リリースの変更点を個別に掲載しました。要約からも案内しています。タグ時点のツリー全体をv0.22.2と比較して検証しました(追加2,303、削除109、変更2,298)。カタログは614件から763件、プラットフォームプラグインは21件から27件に増加しました。プロバイダー数41、メモリプラグイン、ロケール、互換性スタブは変わらず、選択画面は39行です。sessions.auto_pruneはfalseに戻りました。mcp_serve.pyとclaw/import-agentモジュールはコアからmcp-serveおよびagent-importersプラグインに移り、委任用バックエンドはagent/に配置されました。本文では、v0.22.0の自動削除に関する箇条書き、OpenClawの記述、Nousへのサインインに関する段落、hermes mcp、hermes plugins、hermes claw、hermes import-agentの行を更新しました。 6465
2026年10月17日 ガイド v1.28:Hermes v0.22.2(タグv0.22.2、10月15日)――修正版のパッチです。v0.22.1は「誤ったコミットからビルドされた」ため、このバージョンに置き換えられました。 冒頭に新機能セクションを追加し、要約からも案内しています。タグ時点でv0.22.1(削除1,135ファイル、変更846ファイル)およびv0.22.0(追加50、削除1、変更205)と比較して検証しました。カタログ614件、厳選モデルを先に表示する選択画面、NemotronのID、プロバイダー数41、行数39、メモリプラグイン、ロケール、互換性スタブはすべて維持されています。一方、gatewayの「セッション権限」の再設計、hermes_state_*モジュール、圧縮時のskillマーカーの修正とそのドキュメントセクションは含まれていません。v0.22.2で新たに加わった修正は、再起動後のgatewayの起動(起動時刻+ホストロック)と、ノートPC上のローカルモデルによる長時間のターン(agent/内の6つの新規モジュール)の2つです。v0.22.1セクションは置き換え済みのリリースとして書き直し、gatewayとローカルモデルのセクションにも修正内容を記載しました。 6263
2026年10月14日 ガイド v1.27:Hermes v0.22.1(タグv0.22.1、10月14日)――v0.22.0に対するパッチです。リリースノートは1文と自動生成されたコミット一覧で構成されています。 冒頭に短い新機能セクションを追加しました。要約からも案内し、選択画面の件数に対応するタグ表記を更新しました。タグ時点で、カタログの601件から614件への増加(デスクトップ用言語パック2件、TeamoRouter、その他の名前付き項目8件)、モデル選択画面で厳選IDを先頭に表示する変更、Nemotron Super 3.5のID、読み込み済みskillに関する圧縮処理の修正を検証しました。プロバイダー数41、静的な行数39、メモリプラグイン、ロケール、互換性スタブに変更はありません。v0.22.0セクションの日付を修正しました。 6061
2026年10月14日 ガイド v1.26:Hermes v0.22.0(タグv0.22.0、日付は10月13日、10月14日公開)――「The Threshold Release」です。v0.21.1からv0.21.7までの全リリースと、v0.21.7以降の756コミットを整理してまとめています。 冒頭に新機能セクションを追加し、要約からも案内しています。取り上げた内容は、nous/welcomeのトライアルとset_themeを使うデスクトップの初回起動ガイド、ホスト型アプリのコネクター(/connectors、hermes connectors)、管理対象のローカルllama.cppモデル、署名付きデスクトップパッケージとhermes pm、600件のプラグインカタログ、Claude 5.5とGPT-6のモデル群、ブラウザーでのパスワードマネージャーによるサインイン、Bot Screen、マシン1台につきgatewayとバックエンドをそれぞれ1つにする構成、サブエージェントモニター、アップグレード時の注意点7項目、取り消された変更の一覧です。CLIの表にhermes connectors、hermes pm、hermes usageを、スラッシュコマンドの表に/connectorsを追加しました。ローカルLLMサーバー、profile、外部メモリプロバイダーの各セクションを更新し、v0.21.7セクションの日付を修正しました。 5859
2026年10月13日 ガイド v1.25:Hermes v0.21.7(タグv0.21.7、10月11日)――5回目の累積パッチです。すべてのチャネル(デスクトップ、Store/MSIX、インストーラー、Docker、Cloud)で提供される初のリリースで、整理されたリリースノートはv0.22.0に持ち越されました。 冒頭に新機能セクションを追加し、要約からも案内しています。タグ時点の実装まで確認して取り上げた内容は、ソースからのインストールがタグ付きリリースを追従する変更(mainへの追従を続けるにはhermes update --set-channel mainを使用、--channel、--install-id、update.installs配下のインストールごとの記録)、デスクトップの更新チャネル切り替え、再開時の署名付き思考の再送とBedrock Converseの推論、安定版チェックでの403とトークンの処理、Holographicのカタログへの移動(コアにはByteRoverとRetainDBが残ります)、カタログの493件から552件への増加です。CLIの表のhermes update行と外部メモリプロバイダーを更新し、v0.21.6セクションの日付を修正しました。 5657
2026年10月11日 ガイド v1.24:Hermes v0.21.6(タグv0.21.6、10月8日)――4回目の累積パッチです。新しい安定版リリースパイプラインによる初のリリース(タグ、GitHubリリース、Dockerイメージのみ)で、整理されたリリースノートはv0.22.0に持ち越されました。 冒頭に新機能セクションを追加し、要約からも案内しています。タグ時点の実装まで確認して取り上げた内容は、stt.streamingによるリアルタイム文字起こし、auxiliary.voice_chatスロット、plugins.isolation: host、さらに4つのメモリプロバイダーのカタログへの移動(Honcho、Mem0、OpenViking、Supermemory。コアにはByteRover、Holographic、RetainDBが残ります)、プラグイン互換レイヤーとallow_deprecated_importsの削除、hermes statusで要約を先に表示する変更(--full、--deep。タグ時点では--shortフラグはありません)、プラグインとして追加できる言語パック、プロバイダープラグインの38件から41件への増加、選択画面へのGPT-6.1 SolとClaude Sonnet/Haiku 5.5の追加、2つの承認検出機構、cronストアの健全性低下、Discordの初期設定、Tenable、git-filter、email-senderに関するセキュリティ修正です。補助モデル、ローカライズ、CLIの表、外部メモリプロバイダー、メッセージングgateway、プラグインシステム、互換性の補足欄、セキュリティ強化を更新しました。 5455
2026年9月24日 ガイド v1.23:ガイドの初版以来、現行リリースの上に置かれていたv0.14.0の導入説明を、新機能の履歴の末尾へ移しました。最も古いセクションとして、ほかの履歴と同じ新しい順に並んでいます。内容の変更はありません。要約は「重要なポイント」から出典の注記、「進め方を選ぶ」へと直接続くようになりました。 ガイドの構成
2026年9月24日 ガイド v1.22:Hermes v0.21.5(タグv2026.9.24、9月24日)――3回目の累積パッチです。整理されたリリースノートはv0.22.0に持ち越されました。 冒頭に新機能セクションを追加し、要約からも案内しています。タグ時点の実装まで確認して取り上げた内容は、Hindsightのコアツリーからプラグインカタログへの移動(リリースノートには記載なし)と自動移行、gateway.multiplex_profiles: falseの廃止、profileごとの待機処理、gateway.standalone、NousとOpenRouterの選択画面へのGPT-6 Sol/LunaとClaude Opus 5.5の追加です。外部メモリプロバイダーには、同梱の7プロバイダーに加えてカタログのHindsightを掲載しました。メッセージングgatewayには、廃止されたオプトアウト設定についての段落を追加しました。互換性の補足欄をタグ時点で再確認し、plugin_compat.pyに変更がなく、回避手段も引き続き機能することを確認しました。同梱のプロバイダープラグイン数は39ではなく38に訂正し、OpenCode Freeの行には削除済みと明記しました。いずれも9月18日からの変更です。 5253
2026年9月23日 ガイド v1.21:正確性と読みやすさを見直しました。対象は引き続きHermes v0.21.4(タグv2026.9.21。これより新しいリリースはありません)です。新機能は新しい順に並べ、v0.21.3には独立したセクションを設け、要約は現行リリースから始まる構成にしました。ペアリングでは、新しい値はdeclineのみです。許可リストが1つでも設定されると、実効的なデフォルト値はignoreになります。YAMLの形式はplatforms.<name>.unauthorized_dm_behaviorまたはトップレベルのキーです。stream-jsonは--query-fileを受け付けるため、オプションの行を追加しました。set-journal-modeには、すべてを停止するルールとWindowsの--forceについて記載しました。ホスト単位で単一インスタンスに制限する説明は、運用者の操作から始まるように変更しました。書き込みプロセスに関する文は削除しました。 5051
2026-09-22 ガイド v1.20:Hermes v0.21.4(タグ v2026.9.21、9月21日)– 2回目の累積パッチです。v0.21.3以降の「マージ以外のコミット5,071件」「変更ファイル5,169件」「マージ済みPR 1,812件」「クローズ済みissue 2,116件」をまとめていますが、リリースノートは簡潔で、整理された解説はv0.22.0に持ち越されています。 v0.21.3のブロックの下に、新機能のセクションを追加しました。主要な数値5つはすべて、記載された計測用コミット 4b8a8134 のローカルクローンで完全に再現できました(タグにはリリースコミットが1件追加され、マージ以外は5,072件です。マージを含む比較の総数は5,173件で、GitHubの比較APIと一致します)。タグ間の変更規模は、v0.21.1の5,139件に次いで過去2番目です(この主張も再確認し、引き続き正しいことを確認しました)。リリースで意図的に文書化されていない項目は、タグ時点のソースを検証したものだけを取り上げ、それぞれ既存の該当セクションに配置しました。ホスト単位のシングルトン(gateway/host_rendezvous.py:ホスト上のOSユーザーごとに hermes serve と hermes gateway run をそれぞれ1つに制限します。ホストロックとランデブーレコードを使用し、(pid, createTime) で生存を確認します。host_attach.py の結果はATTACH/RESCAN/REPLACE_HOST/REFUSE/STARTの5種類です。Desktop側の host-backend-attach.ts は台帳 -> HTTP -> トークン -> WSの順に処理し、ホスト単位で起動を制御します。Messaging Gatewayに説明段落を追加しました)。バックエンドが管理する単一のコネクター操作(tools/connectors/operation.py は「純粋なデータのみで、I/Oはありません」。期限は300秒で、意図的に設定キーにはしていません。タグ時点のテストに基づき、Desktop/TUI/CLIで manage_connections の設定カードを確認しました。Nousの無料枠のサブセクションを拡充しました)。--format stream-json(_parser.py:247-249 + hermes_cli/stream_json.py:system/init -> text/tool_use/tool_result -> 単一の result エンベロープという流れです。-q が必須で、--quiet が暗黙に有効になり、--tui は拒否されます。ツールの文字数上限は5,000文字です。チャットオプションの表に行を追加しました)。skills.auto_load(config_defaults.py:1435:「すべての新しいセッション(CLI、TUI、gateway、cron、API)で完全に読み込まれた状態に固定されます」。プロンプト構築時に1度だけ解決し、見つからない名前は警告してスキップします。HERMES_IGNORE_RULES で抑制できます。固定するskillのサブセクションを新設しました)。gatewayの decline(gateway/config.py:139:丁寧な拒否メッセージを1度送った後、DECLINE_DEDUPE_SECONDS #88028に従って24時間は応答しません。unauthorized_dm_decline_message を使用し、プラットフォームごとの設定は platforms.<name>.extra で行います。Emailのデフォルトは ignore です。ペアリングのセクションを拡充しました)。mcp.discovery_concurrency(config_defaults.py:526:デフォルトは4、0は無制限です(#117373)。無効な値には警告を出し、デフォルトに戻します。どのサーバーにも接続は行われます。MCPのセクションを拡充しました)。session_search のafter/beforeと、OR条件に緩和した再試行(ツールスキーマ :708-725:境界を含む/含まない指定ができ、ISO形式または 7d/24h/2w を使用します。hermes_state_search.py:1151-1163 では、結果が0件の場合、unicode61インデックスでいずれかの検索語に一致する条件で再試行します。完全一致の意味は維持され、OR/NOT/単一語/CJKは対象外です。セッション検索のセクションを拡充し、同セクションに残っていた古い「Gemini Flashによる要約」という記述も、34に基づいてv0.15.0のLLMを使わない単一形式の設計に修正しました)。hermes sessions set-journal-mode delete\|wal(subcommands/sessions.py:177 + sessions_cmd_journal_mode.py:#100896に対して、オフラインで自力で対処できます。他のプロセスによる保持がある場合は拒否し、ヘッダーの18/19バイト目を検証します。doctorからもこのコマンドが案内されます。sessionsの行とセッションストレージの説明を拡充しました)。Desktopの一連の更新(フォントフィールド desktop.font_family がテーマの --dt-font-sans を上書きします。アクセシビリティを優先した候補を提示します。「エンジンを更新」ではワンクリックでランタイムを更新でき、失敗時には再試行の選択肢が表示されます。Pluginsハブでのアンインストールは、確認を経て plugins.manage remove / Electronローダー経由で実行されます)。動画カタログ(plugins/video_gen/fal の ltx-2.5 + kling-o3 を、タグ時点の対応機能を示す文字列とともに確認しました。toolsetリファレンスの一覧表に行を追加しました)。プラグインカタログの拡充(対象期間中に plugin-catalog/ は9件から228件に増加しました。SHA固定のYAMLを受け入れ、プラグイン別/作者別のWebページでは、固定コミットのREADMEを許可リスト方式のレンダラーで表示します。追加順/更新順の並べ替えにはコミッター日時を使用します。リリースで紹介されたコミュニティ製プラグイン10件が、実際のスラッグ hermes-tailscale/hermes-ssh/shodan/hermes-terminal/hermes-rss/hermes-resetwatch/done-bell/kiwi/cognee/web-octen で存在することを確認しました。プラグインシステムの説明を拡充しました)。一連の修正カテゴリ(profile/多重化の分離、cron、カンバン、Desktop、state.db)は、リリース自体の先送り方針に従い、v0.22.0の調査まで保留しました。互換性の状態を再検証しました。パスを削除する差し戻しは、依然として取り込まれていません。マニフェストとshimは v2026.9.21 にも、a53b42ddea 時点の main(2026年9月22日、同日に取得)にも存在します。対象期間中の plugin_compat.py の変更は、プラグイン走査キャッシュとWindowsパスのPOSIX形式化のみです(#112576)。真偽値リテラルのガードは :261-268 から :296-303 に移動しましたが、引き続き is True です。v0.21.1の箇条書き、v0.21.3のブロック、プラグインシステムの囲み記事、42を最新の確認結果に更新しました。v2026.9.21 で再確認した件数は、静的プロバイダーが 39(models_catalog_static.py:311 のASTによる集計)、プロバイダープラグインのディレクトリが 39 で、いずれも変わっていません。要点セクションのプロバイダー数の確認タグを v2026.9.14 から v2026.9.21 に更新し、v0.21.3の「現行リリース」という表現を削除しました。 505142
2026-09-15 ガイド v1.19:Hermes v0.21.2(タグ v2026.9.11、9月11日)「state.db パッチリリース」+ v0.21.3(タグ v2026.9.14、9月14日)、およびプラグイン互換性サポート期限後の状況です。 v0.21.1 のセクションの下に新着情報セクションを追加しました。v0.21.2(「マージ以外のコミット947件」「マージ済みPR 312件」「貢献者140人」)の中心は、state.db の信頼性向上の取り組みです(PR 6件、課題44件:ホスト型ルームの連携処理をルートストアから shared-state.db に移行しました。gateway/hosted_rooms.py:398-426 を当該タグで検証済みです。ダッシュボードは最初に読み取り専用で開きます。cron の保護処理には追跡対象の接続レジストリを使用します。doctor --fix は安全性を証明できない checkpoint を拒否します。FTSインデックスの破損時はターンを停止せず、検索機能を縮退させます。破損した行は sessions list を停止させず、? と表示します。バインディングを profile に固定しました。読み取り専用で開く際に書き込みロックを取得しなくなり、4〜20秒から0.01秒に短縮されました。運用者向けの案内はリリースの記述を維持し、まず hermes doctor、次に hermes sessions recover --inspect-only を実行する流れとしています。パーサーは hermes_cli/subcommands/sessions.py:185-196 にあり、このサブコマンドは対象期間より前から存在します(v2026.8.31 にも存在します)。そのため、新機能ではなく、今回ガイドで新たに取り上げた機能として記載しています)。複数の profile 間の分離を強化しました(#107609〜#107630 では、v0.19.0 以来掲げてきた「完全に分離」という説明に対し、実際に存在していた穴を塞ぎました。許可リストの継承、デフォルト profile のホストへの認証情報流出、stdio MCP サーバーへの保管庫のシークレット流出、profile をまたぐ MEDIA: 添付、別の profile の Nous Bearerトークンが対象です。実態を正確に伝える注記を、profile のセクションとメッセージング gateway の多重化に関する段落に追加しました)。パスワードをエージェントに見せない認証情報保管庫も取り上げています(1Password、Bitwarden、またはローカル保管庫を利用して、ログイン、支払い、自動入力を行います。名前空間で区切られたハンドルはメタデータのみを扱い、パスワードは入力時に取得します。マスターパスワードがツールの引数になることはありません。保存済みの認証用キーからTOTPを生成します。agent/vault_backends/ と agent/vault_store.py:74-105 を当該タグで検証済みです)。プラグインカタログ(hermes plugins browse/search、カタログ対応の install、pack install/export/show。SHAで固定されます。サブパーサーを当該タグで検証し、プラグインシステムのコマンドブロックを更新しました)、Nous の無料枠と初回起動ガイド(無料の推論とコネクター、チャットからの /login、値が厳密に 1 の場合にのみ有効になる HERMES_GUEST_ONBOARDING=1。guest-onboarding-flag.test.ts を検証済みです。Nous Tool Gateway の下に新しいサブセクションを追加しました)、デスクトップでプロセスが大量生成される問題の修正も掲載しています。v0.21.3 の短いブロック(「マージ以外のコミット1,036件」「マージ済みPR 338件」。自動更新されるCloudエージェントに配信するためにタグが作成されました)では、トークン更新を同時に1件だけ実行することで、更新要求の集中によるセッション失効を解消した修正(コミット 5dea46d13d、#110061)と、state.db の書き込みハンドルの重複を防いだ修正(コミット 939a2f64b4、#110934)を取り上げています。どちらも v2026.9.11..v2026.9.14 の期間内でのみ検証しました。リリース自体が掲載を延期するとした説明(「この期間の変更を整理した完全なリリースノートは v0.22.0 とともに公開し、v0.21.0 以降のすべてを記録します」…「この期間の変更を省略することはありません」)を引用し、意図的に未記載とされた項目(推論の思考量の選択UI、OpenRouter PKCE、HEIF/AVIF、FAL関連の一連の変更、Slack Agent Sessions API、VM間のWALの拒否)をこの行に明記したうえで、v0.22.0 の調査まで保留しています。v0.21.1 の分割に関する箇条書き、プラグインシステムの囲み記事、42 では、互換性サポート期限後の状況を過去形に書き換えました。無効化はコードの差し戻しではなく、日付による判定で予定どおり発動しました(v2026.9.14 の hermes_cli/plugin_compat.py:32 で COMPAT_REMOVAL_DATE を設定し、:86-90 の removal_in_effect() は2026年9月14日以降に真となります)。対象のプラグインは現在、赤い通知とともに無効化されます。ただし、古いインポートパスを削除する差し戻しはまだ適用されていません(COMPAT_MANIFEST.md、compat_manifest.json、互換用シムは当該タグと、5d59366010 時点の main の両方に存在します。取得日時は2026年9月15日12:55 PTです)。そのため、plugins.allow_deprecated_imports: true を設定すれば、対象のプラグインを引き続き読み込めます。使えるのは真偽値リテラルのみです(plugin_compat.py:261-268、is True。引用符で囲んだ文字列では回避を有効にできません)。変更履歴のみに掲載し、リリースまたはソースで検証した内容は次のとおりです。Telegram の bots_require_mention はボットに @メンションを必須とし、ボット同士の応答ループを防ぎます。hermes -z --resume はセッションを再開します(-z = --oneshot、hermes_cli/_parser.py:113)。受動的な更新確認は、30分ごとのgit fetchに代わり、GitHub API へのアクセスを1日最大1回に抑えます(v2026.9.11 の banner.py:129-131、v2026.9.14 の :136-139)。hermes backup -k/--keep はデフォルトで最新のzipファイル3件だけを残します(subcommands/backup.py:24-26)。また、config.yaml のバックアップは、保存数に上限のある単一の backups/config/ ディレクトリに保存されます。model_thresholds のキーは provider:substr の形式でプロバイダーごとに指定できます(agent/context_compressor.py:1558-1567)。--clone-all は cron ジョブをコピーしなくなりました(このフラグは hermes profile のものです。subcommands/profile.py:24 にあり、hermes cron のものではありません)。kanban promote は未完了の親を拒否し、kanban_request_review は不明なレビュアーの profile を拒否します。/model と補助モデルの自動選択では、選択していないプロバイダーに課金が発生することも、認証情報のないプロバイダーに自動で切り替わることもありません。選択UIに DeepSeek V4.1 Flash(Nous Portal + OpenRouter)、GPT Image 2.5、およびネイティブの Anthropic 選択UI向けの Opus 5 + Fable 5.1 が追加されました。debug share でdpasteにフォールバックした場合の保存期間は1日に短縮されました。v2026.9.14 で再確認した値は、静的プロバイダー数が 39(models_catalog_static.py:314 の CANONICAL_PROVIDERS をASTで集計)、プロバイダープラグインのディレクトリ数も 39 で、どちらも変更ありません。--max-turns のデフォルト値500は現在 cli.py:404 にあります(41 の cli.py:400 は、そのタグに対して引き続き正確です)。model_catalog.ttl_minutes は20です(config_defaults.py:1866)。v0.21.1 の変更期間が最大という記述(5,139件)は、新しい2つの期間(ローカルで集計したマージ以外のコミット数は959件と1,037件)と比較しても正しいままです。要約のプロバイダー数の確認タグを v2026.9.7 から v2026.9.14 に更新しました。 484942
2026-09-08 ガイド v1.18:Hermes v0.21.1(タグ v2026.9.7、9月7日)– 累積パッチ:タグ間の変更量は過去最大(「マージ以外のコミット5,139件」「マージ済みPR 632件」)ですが、パッチノートは意図的に簡潔にまとめられ、整理されたリリースノートはv0.22.0に持ち越されています。 Pantheonセクションの上に新機能セクションを追加し、ソースで検証した6つの領域をまとめました。9月のモジュール分割と2026年9月14日のプラグイン互換性対応期限(COMPAT_MANIFEST.md:移動後に遅延解決される名前1,148件、名前ごとに1回のHermesPluginCompatWarning、hermes plugins compatチェッカー、回避策のplugins.allow_deprecated_imports。プラグインシステムに互換性維持期間の囲み記事を追加)、明示的な操作でのみ区切られるgateway会話(SessionResetPolicyは現在無効です。メッセージングgatewayを更新し、claw移行リストに注記を追加)、MCPのデバイスコードOAuth(hermes mcp login --flow device、RFC 8628。MCPのコマンドブロックにloginとreauth --allを追加。OAuthセッションを通じたprofileの所有権、不正なメタデータキャッシュの無視、デスクトップクライアント内のローカルコールバック、-tによるMCPサーバー起動の絞り込み)、委譲の信頼性(delegation.independent_completionsとタスクごとのgroupによる完了単位。デフォルトでは呼び出しごとに1回の完了通知。結果にorphaned_processesとunread_completionsを明記するバックグラウンドプロセスの引き継ぎ。delegation.fallback_providers。正規化処理で検証された子エージェントのチェーン。クラッシュ後も残る部分結果。子エージェントは1時間のキャッシュ階層を継承しません。すべて当該タグの委譲ツールのソースで確認)、プロバイダーとモデル(fast/flex階層を備えたGPT-6 AstraとAstra Pro。Codex OAuthではアカウントごとに利用が制限され、オプトインの-900kバリアントも用意されています。claude-fable-5.1。gemini-3.7/3.8-flash。qwen3.8-max-0902。Muse Spark 1.3とmuse-image image_genプラグイン。Tavilyの検索と抽出。管理対象のllama.cppランタイム。外部プロセス型プロバイダー。model_catalog.ttl_minutesによる20分間隔のカタログ更新)、デスクトップの機能拡充(注釈ごとにセレクター、マークアップ、スタイルを保持し、領域ごとにバッチ化するアプリ内ブラウザーのコメントモード。構造化されたセッション操作と自動化操作。ドラッグによるセッション作成。他形式の会話記録からのセッションインポート。display.resume_last_session。初回起動時の実profile利用への同意。組み込みの任意追加skillカタログ。デスクトップのロシア語ロケール)です。変更履歴のみに記載した、コミットまたはソースで検証済みの項目:cronの信頼性(修正を確認した3つのコミットによる再起動時の引き継ぎの強化、終端状態の保持を伴う配信重複排除処理の直列化、一時停止状態のジョブ作成時の競合解消、Discord cronのメディアを対象の宛先に送信し、アップロード失敗を報告する処理、通知を出さない監査実行をまたいだ継続性の維持)、承認処理でのシェル解析(GNU envの分割時のエスケープとargv0オペランド、envのargvとシェルコメントの境界、引用符で囲まれたコマンド置換本体のコマンド境界の保持、隔離コンテナー内のapprovals.deny)、gateway起動時の生存監視ウォッチドッグ(hermes_startup_watchdog.py。gateway.startup_watchdogの期限は300秒、強制終了コードは75)、state.dbの耐障害性(sqlite3の.recoverによるlost-and-foundデータの救出、like_scanのFTSルーティング、新規のdocs/state-db-recovery.md)、パフォーマンス(ローカルPOSIXホストではsearch_filesがripgrepをネイティブに実行、スキーマv30では委譲先の子エージェントの会話記録をtrigram FTSインデックスから除外、メイン処理と補助処理でOpenAI httpxクライアントを共有)、gateway.trust_env、Slack Block Kitの/model選択UI、リモートサンドボックスのメディア配信(認証情報とそれを指すシンボリックリンクはサンドボックス外に出ません)です。トラブルシューティングには、古いHERMES_MAX_ITERATIONS設定が残っていないかを調べるdoctorチェックを追加しました。タグ時点の再確認対象をv2026.8.31 -> v2026.9.7に更新:静的プロバイダーは39、プロバイダープラグインのディレクトリは39で、いずれも項目はv0.21.0と同一です。調査前の「静的プロバイダーは38件、xaiはプラグインに統合済み」という主張は、ソースで誤りと確認されました(xaiのタプルは静的リストに残っており、移動したのはファイルだけです。hermes_cli/models.py -> hermes_cli/models_catalog_static.py:311)。全体像の説明とCLIのデータフローでは、prompt_builder.pyのパスをagent/prompt_builder.pyに更新しました。v0.16の1時間ごとのカタログ更新という記述は、そのバージョンに限定した説明として残し、20分間隔の更新を併記しました。既存の記述を再検証し、変更がなかった項目:hermes approvals testの名称に関する注記、--max-turnsのデフォルト値500(当該タグのcli.py:400。60と記載された古いdocstringは反映していません)、read_fileの2000行、委譲の上限250/10、compression.tail_mode: lean、Node 26、CLIの17ロケールです。 41424344454647
2026-07-28 ガイド v1.12:検索需要に基づく内容の補強 — コンバージョン率の高い2つのトピックに、検索からの到達先となる見出しがありませんでした。 新しいリリースはありません。GSCでは、hermes swarmとhermes agent swarmが検索順位約8位で4.4〜6.3%、hermes smart model routingが6.7位で4.9%のコンバージョン率を記録していましたが、どちらにも専用セクションがありませんでした。swarmはマルチエージェントKanban内の本文と変更履歴の行にしかなく、「smart model routing」は脚注にしか登場していませんでした。マルチエージェントKanbanの下にHermes Swarmとは?を追加しました。swarmを1つの永続的なボード上で並列に動くワーカー群と定義し、v0.15.0のswarmトポロジー、自動分解、タスクごとのモデル上書き、スケジュール済みタスク、worktree管理を説明しています。各仕組みが防ぐ問題も表にまとめました。プロバイダーのローテーションとフォールバックをスマートモデルルーティング:プロバイダーのローテーションとフォールバックに改題し、認証情報プール、フォールバックモデル、補助ルーティングを1つのシステムとして結び付ける導入文を追加しました。内部からアンカーへのリンクはなかったため、改題によるリンク切れはありません。 73 2 6
2026-08-31 ガイド v1.17:Hermes v0.21.0「The Pantheon Release」(タグ v2026.8.31、8月31日)– 整理された累積リリースノートが公開されました。 Heraldセクションの上に新機能セクションを追加し、リリース自体の機能分類に沿って整理しました。デスクトップに同梱され、デフォルトで有効になったBot Mode(名前付きprofile、決定論的に生成されるアバター、@メンション付きグループチャット)、hermes peerによるボット間DM(返信は各エージェントの正式なBot Chatに届きます)、cronの継続性(continuity=true、永続的なメモ帳、監視モードでのLLMのスキップ、ジョブごとの推論労力の固定。スケジュール済みタスクセクションに、当該タグ時点の4つすべての仕組みを追加)、実行中のサブエージェントの統括(delegate_taskのlist/steer/stop、JSONスキーマに従う子エージェントの出力、デフォルトを250反復/同時実行の子エージェント10件に引き上げ。config_defaults.pyのソースで確認しており、委譲ドキュメントページの3/50は古い値です)、MCPコマンドセンター(hermes://インストールリンクも追加。MCPセクションを更新)、CLIの機能拡充(スラッシュコマンド表に/paletteとCtrl+P、および共通レジストリを使う/statusを追加。入力に応じて絞り込む/modelを記載。リリースノートの名称hermes approval-checkは、当該タグではhermes approvals testであると確認しました。hermes approval-checkというサブコマンドは存在しません)、エージェントが操作するアプリ内ブラウザー、プロバイダーとモデルの拡充(6つの新規プロバイダー。対応表にTencent TokenPlan、Nebius Token Factory、Ramp Router、Alibaba Token Planの行を、ドキュメントから引用した環境変数とともに追加。model_overrides。データの学習利用階層に関する警告。pipのプロバイダープラグイン)、セキュリティ強化(AGENTS.md/skills/memoryへの書き込みには常に承認が必要です。security.protected_instruction_files: trueとtools/file_tools.pyの承認チェックを当該タグで確認。機密情報のマスキング処理の全体的な見直し。Windowsでの承認対象の拡大。hermes desktop --setup-tcc-identity。Blender MCPの削除。セキュリティ強化に第4弾を追加)、gatewayの成熟、8つのskillの追加、取り消された変更のリスト(Model Councilの/council、DCP context engine、WS専用gatewayサーバー。ただし、シーケンス番号付きリプレイの#94219はリリースに含まれています。Electronは40.10.2に戻りました。取り消された機能がガイドに記載されていないことをgrepで確認)です。累積リリースのサブセクションで案内していたリリースノートの延期は解消され、整理済みのセクションを参照するようになりました。各期間のブロックは、タグごとの記録として残しています。タグ時点の再確認対象をv2026.8.27 -> v2026.8.31に更新:静的プロバイダーは38 -> 39(+tencent-tokenplan)、プロバイダープラグインのディレクトリは37 -> 39(+nebius-token-factory、+router。どちらもauth_type="api_key")、ドキュメントのプロバイダー行は41 -> 45です。変更がなく、再検証した項目:ドキュメントのプラットフォーム行28件/Platform列挙型のメンバー24件(リストは同一)/アダプターディレクトリ22件、同一の_BUILTIN_SUBCOMMANDS(73件。peerは累積リリース対象期間から存在し、versionはありません)、ターミナルバックエンド7件とプラグインレジストリ(レジストリはバイト単位で同一)、パーソナリティ14種とロケール17種(それぞれバイト単位で同一/リストが同一)、圧縮のleanデフォルトと補助スロットの一覧、バイト単位で同一の_startup_fast.py/portal_cli.pyです。検証中に判明した記述のずれも修正しました。TTYでのhermes chat -qは、現在は初期入力を渡して対話セッションを開始します(新しい--oneshotで、回答後に終了する動作に戻せます)。また、当該タグのパーサーのヘルプに基づき、チャット表の--max-turnsのデフォルト値を90 -> 500に修正しました。 35363738394033
2026-08-27 ガイド v1.16:Hermes v0.20.6(タグ v2026.8.27、8月27日)– 第4次ロールアップ。 ロールアップの小節に、リリース自体の説明に基づく第4の集約期間を追加しました(v0.20.5以降、約1,557ファイルにわたる約1,313コミット、+177,113 / −21,682、マージ済みPR約525件)。内容は、同意を条件とする実際のprofileでのブラウジング(デフォルトのChromium profile、Windowsでの承認を伴う終了フロー)、独立したOSウィンドウで動作するデスクトップBrowser、管理されたSSHリモート更新エンジンとフリートのprofileレール、リモートMCPカタログの拡充(Cloudflare、Grafana Cloud、Better Stack、Railwayなど、実稼働を確認済みのベンダー運営サーバー50以上)、保存済みシークレットのOSキーチェーンによる暗号化(任意で有効化)、モデル選択画面への新モデル追加(GLM-5.3-Flash、MiniMax M3無料版、MiniMax H3 Max動画)、web_search/web_extractのTTL付き結果キャッシュ、語幹処理を備えた複数クエリのtool_search、制御ソケット経由でgatewayを一時停止するアップデーター、イメージ/パッケージ管理のインストールでの安全でない直接更新の拒否、cronの永続化されたインシデントへの確認応答、Slackのリンク展開制御、共有DockerコンテナーIDです。リリースの記載のうち2点が既存の節と矛盾していたため、両方をタグ時点の内容で確認して修正しました。lean-tail圧縮がデフォルトです(「コンテキスト圧縮」をタグ時点のキーに合わせて書き直しました。tail_mode: lean、threshold_tokens、protect_first_n、auxiliary.compression.*配下の要約設定と、設定バージョン17への自動移行を反映し、逆の説明になっていたトラブルシューティングの注記も修正しました)。また、ターミナルバックエンドはプラグインで拡張できます(プロバイダー選択画面と同様に、7つの組み込みバックエンドとプラグインレジストリという構成で説明し直しました。組み込み名は予約済みです)。タグ時点の検証情報を再確認し、v2026.8.19 → v2026.8.27に更新しました。静的プロバイダー38件+プロバイダープラグインディレクトリ37件、Platform列挙型のメンバー24件/アダプターディレクトリ22件/ドキュメントの表28行、versionサブコマンドなし(_BUILTIN_SUBCOMMANDSは73項目で、worktreeあり)、パーサーオプションと引用したヘルプ文字列に変更なし、BUILTIN_PERSONALITIESは引き続き14件(helpfulからhypeまで)です。locales/は現在17カタログ(en+16言語の翻訳。タグ時点の件数を追加しました)となっています。mainはタグと同一の位置にあります(ahead_by: 0、ステータスはidentical)。検証中に見つかった記述のずれも修正しました。補助システムのデフォルトに関する説明が古く、現在のautoは、OpenRouter → Nous → Codexの検出を経てGemini Flashに振り分けるのではなく、すべての補助タスクをメインのチャットモデルに振り分けます。「補助モデル」をタグ時点のスロット一覧に合わせて書き直しました(title_generation、tts_audio_tags、triage_specifier、kanban_decomposer、profile_describerを出典付きの短い説明とともに追加しました。web_extractとsession_searchのスロットは上流で削除され、どちらもLLMを使わなくなっています。flush_memoriesもデフォルトから削除されています)。Anthropic専用のトラブルシューティング項目も、根拠を確認し直しました。リリースの新規インストール用の行ではGitHubスクリプトのraw URLが使われていますが、ガイドでは正規のhermes-agent.nousresearch.com/install.shを維持しています。整理されたリリースノートは、引き続きv0.21.0で提供される予定です。 293031323334
2026-08-26 ガイド v1.15:訂正 – 新しいリリースはありません(最新タグはv2026.8.19/v0.20.5、8月21日)。既存の記述をタグ時点の内容で再検証しました。 ターミナルバックエンドは6つ → 7つに修正し、vercel_sandboxを表と設定コメントに追加しました。メッセージングプラットフォームは、残っていた「22」という件数を、タグ時点のドキュメント比較表の28に統一しました。集計基準(組み込みPlatform列挙型のメンバー24件、同梱アダプターディレクトリ22件)を明記し、gateway一覧にntfyとBuzzを追加しました。プロバイダーは「約20/約22の正式対応」を、出典に基づく件数(静的なCANONICAL_PROVIDERSの38項目に、同梱のプロバイダープラグイン37件からの自動拡張が加わります。ドキュメントページにはクラウド/サブスクリプションの行が41件あります)に置き換え、「完全な一覧」という表現を削除しました。Qwen OAuthの行を修正し、比較表に17行を追加しました(OpenCode Free、OpenAI API直接接続、Vertex AI、Azure Foundry、Bedrock、NVIDIA NIM、Ollama Cloud、StepFun、MiniMax OAuth、Meta AI、NovitaAI、Arcee AI、GMI Cloud、Actual Computer、Tencent TokenHub、CommandCode、Alibaba Coding Plan)。hermes version → hermes --versionに修正しました(タグ時点ではサブコマンドではありません)。hermes honchoにはプラグインが必要である旨を注記しました。「フリートの--plan」をhermes update --planに修正しました。「グローバルオプション」に--in、--tui、--cli、--dev、--ignore-rules、--ignore-user-configを追加しました。「トップレベルコマンド」には_BUILTIN_SUBCOMMANDSから34行を追加し、hermes worktree list\|pruneとそのフラグも含めました。スラッシュコマンド/worktreeを追加し、hermes setup --portalとhermes portal login\|info\|open\|toolsを記載しました。検証時点のmainはタグより1,104コミット先にありました(その後、すべてv2026.8.27に集約されています)。整理されたリリースノートはv0.21.0で提供される予定です。 23242526272829
2026-08-24 ガイド v1.14:v0.20.5(タグ v2026.8.19、8月21日公開)。 ロールアップの小節に、第3の集約期間を追加しました(v0.20.4以降、約746コミット/約323件のPR)。内容は、キー不要のWeb枠(5ベンダーの無料枠を巡回し、リング方式でフェイルオーバーします。新規インストールでもキーなしでWeb検索を利用できます)、CLIの改善(あいまい検索対応の/model選択画面、Ctrl+Pコマンドパレット、情報を充実させた/status)、Bot Modeのグループルームスレッド+折りたたみ可能な要約+PDF/ファイルのドラッグ&ドロップ、hermes worktree list/prune、hermes updateの実行記録とフリートの--plan検証、ジョブごとの推論強度を設定できるcronの永続メモリ、Composioの評価結果を受けた実行規律の停滞防止策、認証不要のopencode-freeプロバイダー、デスクトップの性能改善(初回描画を優先するハイドレーション、両レンダラーへのReact Compiler導入)です。整理された完全なリリースノートを含むv0.21.0は、引き続き公開待ちです。要約はリリース自体の対象期間の説明に基づいています。ヘッダーのバージョン履歴を更新しました。 23
2026-08-20 ガイド v1.13:v0.20.3(タグ v2026.8.16.2、8月17日公開)とv0.20.4(タグ v2026.8.18、8月18日)。 Herald Releaseの下に新しい小節を追加しました。一連のロールアップは、安定化に加えて機能も提供するようになっています。v0.20.3(約250コミット/約125件のPR):2026-07-28のステートレスプロトコルに対応したMCP 2.x SDKへの移行、中核となるチームメイトプロトコルを備えたBot Modeプラグイン(hermes-bots)の同梱、CommandCodeプロバイダープラグイン、Cua Driver 0.20のコンピューター操作ランタイムの契約、Pythonランタイムの所有権管理の強化、cronスケジューラーの自己修復、セッション引き継ぎ時のデータ消失の修正、エコシステムからの移植(/worktree、/rollbackでの手動編集の保持、プラグインインストール時のセキュリティスキャン)です。v0.20.4(約146コミット/約74件のPR):すりガラス効果の選択機能を備えたデスクトップのガラス/半透明表示、Botごとの非表示/再表示に対応したタブ式SESSIONS|BOTSサイドバー、skillインストール時のNVIDIA SkillEvaluator Tier 1助言スキャン(ライセンス+セキュリティ)、cronのメディア送信の堅牢化、hermes updateで保留中のブランチの状態を正確に報告する修正です。両リリースとも、整理された完全なリリースノートはv0.21.0で提供するとしています。要約は各リリース自体の対象期間の説明に基づいています。ヘッダーの文とタグ履歴を更新しました。 68
2026-08-16 ガイド v1.12:v0.20.0「The Herald Release」(8月3日、タグ v2026.8.3)と、安定化タグのv0.20.1(8月13日)、v0.20.2(8月16日)。 現在は機能しない手順を3点修正しました。Node 26が必須です(インストーラーはNODE_VERSION="26"に固定し、古いランタイムを拒否します。ドキュメントサイトのNode v22という記述は古いため、インストーラーとリリースノートを優先します)。pipとHomebrewは非推奨ではなく、対応が終了しています(「対応している導入経路はシェルインストーラー/Docker/Nixです」)。また、デフォルトの反復回数上限が90 → 500に変更され、予算逼迫の表にあるすべての数値が無効になっていました。インストールコマンドを正規のhttps://hermes-agent.nousresearch.com/install.shに修正しました。削除された項目として、skillソースのclaude-marketplaceがなくなり、ソース一覧ではbrowse-shに置き換えられています。デフォルトのGitHubタップは現在、openai、anthropics、huggingface、NVIDIA、gstackです。メッセージングgatewayは、ドキュメントの比較表を直接数えて22 → 28プラットフォームに修正しました(ドキュメントには公式の総数が記載されていません)。Windows(ネイティブ)は初期ベータではなくTier 1で、macOSはApple Siliconのみ対応です。新しい節ではリリース自体を取り上げ、割り込み発話に対応した音声会話、A2A v1.0、署名付きの送信ライフサイクルWebhook、grounded-citations skill、!//init//diff//context//focusという一連のCLI機能とhermes import-agent、コマンドヘルパーを使うシークレット取得元、hermes -wのコールドスタートの約14秒 → 約1.8秒への短縮、デスクトップ配布物とプラグインSDKを説明しています。3つの認証経路、~/.hermes/の構成、hermes update、記載済みのツール一覧に変更がないことも確認しました。 69
2026-07-21 ガイド v1.11:v0.19.0「The Quicksilver Release」(2026年7月20日、タグ v2026.7.20)。「v0.19.0の新機能」セクションを追加しました。初回ターンのTTFTを約80%短縮(CLI/gateway/TUI/デスクトップ/cronで、コールド状態の送信→ディスパッチが約4.3秒→約0.9秒)。推論過程はデフォルトでリアルタイムにストリーミング表示されます(display.show_reasoning がON)。デスクトップでは約20件のPRによる高速化(Markdownのストリーミング表示が14倍高速に)、TUIではMarkdownの差分更新を導入しました。pip/Homebrewでのインストールを非推奨化(「サポート対象外のレガシー」として警告のみを表示し、PyPI/Homebrewへの公開は廃止予定)し、インストールセクションと要点を1行インストーラーの案内に修正しました。差し替え可能な SecretSource にBitwarden + 1Passwordプロバイダーを追加(op:// 参照、複数保管庫、決定的な優先順位、変数ごとの取得元追跡)。スマート承認をデフォルト化(フラグが付いたコマンドごとに独立したLLMレビュアーが確認)し、YOLOでも有効なユーザー定義の拒否ルール、/deny <reason>、プラグインの pre_tool_call による承認エスカレーションを再導入しました。ターミナルでの請求管理に /subscription + /topup、デスクトップに請求タブを追加(「専用のサブスクリプションコマンドはない」という記述を削除)。サブエージェントのリアルタイム実行ログ + 永続化されたバックグラウンド委任 + 結果の配信義務を追跡する台帳を state.db に導入しました。委任の同時実行数制限を統一し、max_async_children を非推奨化しました。gatewayのprofileに基づくメッセージルーティング(1つの多重化されたボットトークン→分離されたprofile、GATEWAY_MULTIPLEX_PROFILES、state.db 内のルーティングインデックス、sessions.json は任意のレガシーミラー)。プロバイダー/モデル:Fireworks AI(選択画面の2番目)、DeepInfra、Upstage Solar、GPT-5.6(Sol/Terra/Luna + Pro)の全経路での対応、grok-4.5の一般提供、kimi-k3(kimi-k2.xは廃止)、Claude Sonnet 5の完全統合、プロバイダーごとの enabled: false + excluded_providers、推論の労力に max/ultra レベルを追加(モデルごと/MoAスロットごとの上書きとセッション単位の /reasoning に対応)。CLI/MCP:hermes sessions export(Markdown/Quarto/HTML/プロンプトのみ/HFトレース、--redact)、/model --once、複数のスラッシュskill呼び出しの組み合わせ、--safe-mode、hermes config get/unset、hermes serve の完全なヘッドレス動作、MCPの mcp__server__tool 命名規則。記載が漏れていたパッチタグ、v0.18.1(タグ v2026.7.7)とv0.18.2(タグ v2026.7.7.2)、2026年7月7日〜8日も追記しました。いずれもインフラ関連のパッチをまとめたもので、v0.18.2の主な修正ではWhatsApp Baileysの旧バージョン固定を解除して7.0.0-rc13に更新し、Dockerのビルドを安定化しています。 70 71
2026-07-16 起動時のエラーメッセージ「No inference provider configured. Run ‘hermes model’ to choose a provider and model」を原文のまま掲載し、トラブルシューティングの最初の項目として追加しました。検索需要を踏まえた追加で、対話式の選択画面、hermes doctor、3つの認証方法へ案内します。製品の変更はありません。 2 7
2026-07-01 ガイド v1.10:v0.18.0「The Judgment Release」(2026年7月1日、タグ v2026.7.1)。「v0.18.0の新機能」セクションを追加しました。P0/P1のバックログをすべて解消(約692件)。Mixture-of-Agentsを正式サポートし、モデルごとにラベルを付けたアンサンブル出力とリアルタイムストリーミングに対応しました。完了条件の契約では、/goal がプロジェクトのチェックを実行し、自らの作業を検証します。/learn(ワークフローの説明→再利用可能なskill、CONTRIBUTING.md準拠)。/journey のメモリ/skillタイムライン + デスクトップのメモリグラフ。バックグラウンドでのサブエージェント並列展開(委任したタスクの同時実行)。Desktop Projects(プロジェクト/リポジトリ/レーン)。処理中のリクエストの完了を調整するゼロスケール対応gateway。Google Vertex AI(GCPサービスアカウント経由のGemini、自動OAuth2更新)。/prompt の\$EDITORによる入力編集。出典:hermes-agent releases。 22
2026-06-21 ガイド v1.9:v0.17.0「The Reach Release」(2026年6月19日、タグ v2026.6.19)。「v0.17.0の新機能」セクションを追加しました。メッセージング:Photon Spectrum経由の中継不要なiMessage(hermes photon login、デバイスコードOAuth)、公式WhatsApp Business Cloud APIアダプター(ブリッジ不要)、SimpleXのグループ + 添付ファイル、Raftプラットフォームプラグイン。モデル:z-ai/glm-5.2(1M)、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra、grok-composer-2.5-fast(xAI OAuth、200k)。xAIのデフォルトを grok-build-0.1 に変更し、Anthropicの適応型モデルでは reasoning フィールドを削除しました。デスクトップ/ダッシュボード:リアルタイム監視ウィンドウ付きのバックグラウンドサブエージェント(delegate_task(background=true))、完全なprofileビルダー、刷新したSkills Hub、Automation Blueprints、安全な401ログイン、VS Code Marketplaceのテーマ、日本語 + 繁体字中国語のUI。skill/ツール:image_generate による画像から画像への編集、memory のアトミックな operations バッチ、simplify-code skill、真偽値の write_approval(write_mode を置換)。アーキテクチャ:MCPの情報入力要求ハンドラー、差し替え可能なCronScheduler + Chronos、Managedスコープ(/etc/hermes)、gateway間の中継。コマンド:/version、/billing、hermes curator run --consolidate(明示的に有効化)。セキュリティ:シェルエスケープによる拒否リストの回避を修正し、承認/gatewayアダプターをフェイルクローズ化しました。cronの環境変数をサニタイズし、デバッグダンプのシークレットを伏せ字にし、MCPのstdio経由の情報流出を検査するほか、urllib3 + PyJWTをCVE対応版に更新しました。 21
2026-06-08 ガイド v1.8:v0.16.0「The Surface Release」(2026年6月5日、タグ v2026.6.5)。ガイドのタイトルをv0.16に更新し、「v0.16.0の新機能」セクションを追加しました。主な変更点は、Hermesがターミナル以外でも使えるようになったことです。ネイティブのHermes Desktopアプリ(Electron、macOS/Linux/Windows)には、ワンクリックインストール、アプリ内の自動更新、ストリーミングチャット、ドラッグ&ドロップ + クリップボードからの画像貼り付け、Cmd+K パレット、セッションのアーカイブ/検索、ステータスバーのモデル選択、安全なWebSocket経由のリモートgateway接続(OAuthまたはユーザー名/パスワード、profileごとのホスト、profile間の @session リンク)、型付きi18nによる完全な簡体字中国語訳を搭載しました。ブラウザー管理パネル(Webダッシュボード→本格的な管理機能):MCPカタログの有効化/無効化、認証情報の管理、webhook/フックの作成、メモリ設定、gatewayの制御、更新前チェック + Debug Shareを備えたSystemページ、新しいChannelsページ、差し替え可能な認証(ユーザー名/パスワード、セルフホスト型OIDC、hermes dashboard register)。新しいコマンド:/undo [N](CLI/TUI/メッセージング)、デフォルトのインターフェース設定(cli/tui、--cli)、TUIで統一された /model + Sessionsオーバーレイ、hermes portal、hermes prompt-size、hermes sessions optimize。新しいモデル:deepseek-v4-flash、MiniMax-M3(1Mコンテキスト)、qwen3.7-plus、gemini-3.5-flash。デスクトップランチャーでxAI Grok OAuthを正式サポートし、あいまい検索対応のモデル選択と1時間ごとのカタログ更新を導入しました。skill:デフォルト構成をスリム化(Spotify→ネイティブプラグイン、Linear→hermes mcp install linear、使えなくなったskillを削除)し、environments: による適合性判定(kanban/docker/s6)、デフォルトで信頼するtapとして NVIDIA/skills、MCP/プラグインのツールを段階的に公開する仕組み(スコープ単位)を追加しました。セキュリティ:CVE-2026-48710(Starlette BadHost)対策としてバージョンを≥1.0.1に固定しました。SSRFチェックをイベントループの外に移し、サブプロセスの環境変数からBedrockのベアラートークンを除去し、bws_cache.json の読み取りを保護しました。危険なパターンに docker restart/stop/kill を追加し、不可視のUnicode文字をサニタイズします。P0を2件 + P1を62件解消しました(うち16件にセキュリティタグ)。 20
2026-05-31 ガイド v1.7.1:v0.15.1(2026年5月29日、01:12 UTC)— Velocityパッチ。Velocity公開と同日にリリースされたホットフィックスで、タグ v2026.5.29 系列に固定しています。ループバックモードでのデプロイに影響する、ダッシュボードの401再読み込みループを修正しました。Dockerでは --insecure が暗黙に適用されなくなりました。再び有効にするには、HERMES_DASHBOARD_INSECURE=1 を明示的に設定してください。MCPのパス指定なしのコマンド(npx、npm、node)が、Dockerコンテナ内で再び正しく解決されるようになりました。Skillsページの取得元バッジとカテゴリのサイドバーが表示されるようになりました。KanbanワーカーはSIGTERMを受けると適切に終了し、孤立したプロセスを残さなくなりました。サイトマップからの検出により、Skills.shカタログは858件から19,932件に拡大しました。28コミット、21件のマージ済みPR、9人の貢献者。v0.15.2(2026年5月29日、13:37 UTC)— Velocityパッケージングパッチ。wheelとsdistの配布物に plugin.yaml マニフェストを同梱するよう修正し、ソースツリーを別途取り込まなくてもPyPIからのインストールが機能するようになりました。パッケージングのみのホットフィックスで、貢献者は4人です。 72
2026-05-28 ガイド v1.7:v0.15.0(2026年5月28日)— The Velocity release(タグ v2026.5.28)を追加しました。主な変更点は、大規模なリファクタリングと新しいオーケストレーションの基本機能です。コードベースのリファクタリング: run_agent.py を76%削減し(16,083行 → 3,821行)、責務ごとにまとまった14のモジュールに分割しました。マルチエージェントKanban v2: 大まかな目標からサブタスクへの自動分解、並列ワーカーを連携させるスウォーム構成、タスクごとのモデル上書き、スケジュールされたタスク、worktree管理を追加しました。パフォーマンス: コールドスタートをさらに1秒短縮し、会話ごとの関数呼び出しを47%削減しました。session_search は再設計により4,500倍高速化し、LLMへの依存を取り除きました(それに伴うAPIのコストもなくなりました)。セキュリティ: Promptware対策により、3つのセキュリティ要所でBrainworm型のプロンプトインジェクションを防ぎます。Bitwarden Secrets Managerとの連携により、プロバイダーごとに複数必要だったAPIキーを、単一の初期認証トークンに置き換えられます。skillバンドル: 1つのスラッシュコマンドで複数のskillを同時に読み込めます。TUIセッションオーケストレーター: 1つのターミナルウィンドウ内で複数のセッションを管理できます。新しいプロバイダー: 画像生成向けにKrea 2(Medium/Large)とFALプラグインをサポートしました。xAI連携の更新では、ウェブ検索プラグイン、OAuthアップストリーム、提供終了モデルの検出、自然なTTSの間を追加しました。統計:1,302コミット、747件のPRをマージ、コミュニティ貢献者321人。GitHubのリリースノートによると、同日またはその後のパッチリリースで、ダッシュボードの401エラーによる再読み込みループ、Dockerの--insecure用の明示的な環境変数、Docker内でのMCPのパス指定なしコマンド解決(npx、npm、node)、Skillsページの復元、KanbanワーカーのSIGTERM処理、サイトマップ経由での全19,932件のSkillsカタログへのアクセスに対応しています。 73
2026-05-21 ガイド v1.6:v0.14.0(2026年5月16日)— The Foundation releaseを追加しました。主な変更点は、インストールと実行基盤の軽量化、およびプロバイダー、gateway、メディア、検証機能の拡充です。1Mコンテキストのgrok-4.3に対応したSuperGrok OAuth、OAuthプロバイダー向けのOpenAI互換hermes proxy、x_searchの正式サポート、pip install hermes-agent、依存関係の遅延インストール、起動時間の約19秒短縮、ブラウザーCDP呼び出しの180倍高速化、LINEとSimpleX Chatの追加による22のメッセージングプラットフォームへの対応、Microsoft Teamsのエンドツーエンド対応、/handoff、/subgoal、Telegram/Discordのネイティブな確認ボタン、Discord履歴の補完、未加工ピクセルを扱うvision_analyze、ターンごとのファイル変更検証フッター、書き込みごとのLSPセマンティック診断、統合されたvideo_generate、Anthropic以外のプロバイダー向けのcua-driver経由のcomputer_use、OSC8によるクリック可能なURL、Zed ACP Registry対応、OpenRouter Pareto Codeルーター、NovitaAI、Codex app-serverランタイム、信頼済みtapとしてのhuggingface/skills、9つの任意追加skill、プラグインのctx.llm / tool_override、Brave/DDGSウェブ検索、Qwen Cloudへの名称変更、Windowsネイティブ対応のベータ版、P0課題12件とP1課題50件の解決を追加しました。 19
2026-05-07 ガイド v1.5:v0.13.0(2026年5月7日)— The Tenacity releaseを追加しました。主な変更点は、状態を永続化するマルチエージェントKanbanボードです(ハートビート、タスクの回収、ゾンビ検出、ハルシネーション検査、タスクごとのmax_retries、複数プロジェクトのボード)。これにより、スウォームを単なる委任パターンではなく、基本機能として扱えます。/goalコマンドは、複数ターンにわたってエージェントを目標に集中させます(Ralph-loopパターンをスラッシュコマンド化)。新しいvideo_analyzeツールはGeminiを優先し、互換モデルへの対応も拡張できます。音声クローンに対応したxAI Custom Voices TTSプロバイダーを追加しました。CLIとgatewayのメッセージを7言語に国際化しました(zh-Hans、ja、de、es、fr、uk、tr)。ドキュメントの翻訳はzh-Hansのみです。交換可能なアダプターパターンにより、Google Chatが20番目のメッセージングプラットフォームとなりました。IRCとMicrosoft Teamsも同じパターンへ移行しました。ProviderProfile ABC + plugins/model-providers/により、コアを変更せずにサードパーティープロバイダーを追加できます。gatewayの再起動、/update、ソースファイルの再読み込み後のセッション自動再開に対応しました。checkpoint v2を、単一ストア設計、実際に不要データを削除する仕組み、ディスク保護機能を備えた実装に書き直しました。P0セキュリティ課題8件を解決: 機密情報のマスキングをデフォルトで有効化、DiscordのギルドをまたぐDMバイパス(CVSS 8.1)、WhatsAppの見知らぬ相手の拒否とセルフチャットのミュート、MCP OAuthのTOCTOU、CLIのauth.jsonのTOCTOU、ブラウザーのSSRF対策の最低基準、cronのプロンプトインジェクション検査、hermes debug shareのマスキングに対応しました。Python/JSON/YAML/TOMLの書き込み後のlint検査、cronのスクリプト専用no_agentモード、Slack/Telegram/Mattermost/Matrix/DingTalkのプラットフォーム許可リスト、MCPの機能強化(SSEトランスポート、OAuth転送、画像MEDIAタグ)を追加しました。v0.12.0以降の統計:864コミット、588件のPRをマージ、829ファイルを変更、コミュニティ貢献者295人、282件の課題を解決(P0が13件、P1が36件)。 18
2026-05-06 ガイド v1.4:v0.12.0(2026年4月30日)— The Curator releaseを追加しました。主な変更点は、gatewayのcronタイマー上で動作する自律型バックグラウンドCuratorです(デフォルトは7日周期)。評価基準に沿ってskillライブラリを採点し、使われなくなったskillを削除し、関連するskillを統合し、実行ごとのレポートを作成します。Hermesは、アクティブなセッションの合間に自身を保守します。自己改善ループには、評価基準に基づく採点、既存skillの積極的な更新を優先する方針、適切なランタイム継承、メモリとskillのみに範囲を限定したtoolsetを導入しました。新しい推論プロバイダー4つ: GMI Cloud、Azure AI Foundry、MiniMax OAuth、Tencent Tokenhubです。LM Studioを正式サポートに昇格しました。 リモートモデルカタログのマニフェストは、リリースを待たずに自動更新されるようになりました。新しいメッセージングプラットフォーム2つ: Microsoft Teams(19番目、交換可能なgatewayアーキテクチャ経由)とTencent Yuanbao(18番目、テキストとメディアにネイティブ対応)です。同梱skillを使い、PKCE OAuth経由でSpotifyにネイティブ対応しました。通話と文字起こし用のGoogle Meetプラグイン、PiperローカルTTSプロバイダーも追加しました。ComfyUI v5とTouchDesigner-MCPは、任意追加からデフォルト同梱に変更しました。 新しいskill:Humanizer、claude-design、design-md、airtableです。CLIへの追加機能:hermes -zの単発実行モード、hermes update --checkの事前確認、/reload-skillsスラッシュコマンド、差し替え可能な処理中インジケーターのスタイルです。エージェントの遅延初期化と遅延インポートにより、TUIが表示されるまでのコールドスタート時間を約57%短縮しました。セキュリティ:ペイロードの破損を防ぐため、機密情報のマスキングをデフォルトで無効にしました。元に戻せない操作を行うコマンドには、厳格なブロックリストを適用します。統計:1,096コミット、550件のPRをマージ、コミュニティ貢献者213人。 17
2026-04-25 ガイド v1.3:v0.11.0(2026年4月23日)— The Interface releaseを追加しました。PythonのJSON-RPCバックエンド(tui_gateway)を備え、対話型TUIをReact/Inkで全面的に書き直しました。固定表示の入力欄、OSC-52クリップボード対応のライブストリーミング、安定した選択キー、ターンごとのストップウォッチとgitブランチを表示するステータスバー、/clearの確認、ライトテーマのプリセット、サブエージェントの起動状況を確認できるオーバーレイを追加しました。交換可能なトランスポートアーキテクチャとして、形式変換とHTTPトランスポートをagent/transports/に切り出し、プロバイダー接続処理を整理しました。Converse API経由でAWS Bedrockにネイティブ対応しました。新しい推論経路5つ: NVIDIA NIM、Arcee AI、Step Plan、Google Gemini CLI OAuth、Vercel ai-gatewayです。Codex OAuth経由のGPT-5.5に対応し、OpenAIの新しいフラッグシップモデルを、別途APIキーを用意せずにChatGPT Codex OAuthから利用できるようになりました。QQBot(17番目のメッセージングプラットフォーム)は、QRスキャンによる設定とストリーミングに対応します。プラグインの拡張範囲を拡充: スラッシュコマンド、ツールの振り分け、実行のブロック、結果の変換に対応しました。/steer <prompt>では、実行中のエージェントに追加の指示を渡せます。エージェントは次のツール呼び出し後にその指示を確認するため、ターンを中断したり、プロンプトキャッシュを無効にしたりせずに軌道修正できます。シェルフックでは、Pythonプラグインなしで、スクリプトをライフサイクルフックとして組み込めます。Webhook直接配信モードは、エージェントを介さずにペイロードをプラットフォームのチャットへ直接転送し、複数の宛先へ配信します。委任機能を改善し、オーケストレーターの役割、設定可能な生成階層の深さ、ファイル操作の調整を追加しました。ダッシュボードには、プラグインシステム、即時のテーマ切り替え、国際化、モバイル向けレスポンシブ対応を追加しました。v0.9.0以降の統計:1,556コミット、761件のPRをマージ、1,314ファイルを変更、224,174行を追加、コミュニティ貢献者29人。 74
2026-04-16 ガイド v1.2:v0.10.0 — Nous Tool Gatewayを追加しました。Nous Portalの有料プラン利用者は、追加のAPIキーなしでマネージドツール(Firecrawlウェブ検索、FAL / FLUX 2 Pro画像生成、OpenAI TTS、Browser Useブラウザー自動化)を利用できるようになりました。新しい設定フィールドuse_gatewayで、ツールごとに利用を有効にできます。gatewayと直接接続用のAPIキーの両方が設定されている場合、実行時にはgatewayを優先します。環境変数HERMES_ENABLE_NOUS_MANAGED_TOOLSは削除しました。Hermes Agent CLIは引き続きMITライセンスで、完全に無料です。 75
2026-04-13 ガイド v1.1:v0.8.0とv0.9.0の機能を追加しました。ローカルウェブダッシュボード、/fastモード、iMessageとWeChatへの対応(合計16プラットフォーム)、バックグラウンドプロセス監視(watch_patterns)、差し替え可能なcontext engine、hermes backup/hermes import、Termux/Android、xAI・MiMo・Google AI Studio・Qwenプロバイダー、/debugコマンド、包括的なセキュリティ強化を扱っています。 15 16
2026-04-10 ガイド v1.0:Hermes Agent v0.7.0を対象とする初版を公開しました。プロバイダー認証、設定、CLI、スラッシュコマンド、ツール、skill、メモリ、gateway、cron、MCP、圧縮、アーキテクチャ、OpenClawからの移行、トラブルシューティング、よくある質問を扱っています。
—

参考文献


  1. Nous Research、GitHub上の“Hermes Agent”プロジェクトREADMEです。製品の説明(自己改善型エージェント、複数プロバイダー対応、メッセージングgateway、ターミナルバックエンド、skillの進化、cronスケジューラー、委任)と、“Quick Install”の1行コマンドの一次資料です。 ↩↩↩

  2. Nous Research、Hermes Agentドキュメントの“AI Providers”です。プロバイダーの全一覧、プロバイダーごとの認証方法(Nous Portal OAuth、Codexデバイスコード、GitHub Copilotのトークン種別、Anthropicの3種類の認証方法、中国のAIプロバイダー、Hugging Faceルーティング、カスタムエンドポイント)、3つの認証経路(.envのAPIキー、hermes model経由のOAuth、config.yamlのカスタムエンドポイント)、/modelスラッシュコマンドの構文(custom:name:modelを含みます)、Ollama/vLLM/SGLang/llama.cpp/LM Studioの設定テンプレート、WSL2のネットワーク設定手順、コンテキスト長の検出順序、フォールバックモデルの設定、スマートモデルルーティング、名前付きカスタムプロバイダーの一次資料です。本記事に登場するプロバイダー固有の環境変数名、トークン種別、ベースURLの上書き設定、モデル識別子は、すべてこのページに基づいています。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  3. Nous Research、Hermes Agent開発者ガイドの“Architecture”です。システム概要図、ディレクトリ構成、CLIセッションとgatewayメッセージの経路に沿ったデータフロー、3つのAPIモード(chat_completions、codex_responses、anthropic_messages)、runtime_provider.pyによるプロバイダーの解決、SQLite + FTS5によるセッションの永続化、メッセージングgatewayの対応プラットフォーム一覧、プラグインシステムの検出元、profileの分離、6つのデザイン原則の一次資料です。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  4. Nous Research、Hermes Agentユーザーガイドの“Configuration”です。設定ディレクトリの構成、config.yamlと.envの使い分けのルール(「機密情報以外の設定ではconfig.yamlが優先されます」)、設定の優先順位(CLI引数 → 環境変数 → config.yaml → .env → 既定値)、コンテキスト圧縮の設定(compression.*ブロック内のthreshold、threshold_tokens、target_ratio、tail_mode、protect_last_n、protect_first_n。config-version-17への移行以降、要約用のモデル/プロバイダー/エンドポイントはauxiliary.compression.*配下にあります)、予算逼迫のしきい値(70%で注意、90%で警告)、ローカルプロバイダー向けの自動調整を備えたストリーミングのタイムアウト、補助モデル設定ブロック全体(auxiliary:内のvision、web_extract、approval、compression、session_search、skills_hub、mcp、flush_memoriesスロット)の一次資料です。"main"プロバイダーを使用できるのは補助/圧縮/フォールバックのスロットに限られるという制約も、このページに基づいています。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  5. Nous Research、Hermes Agentガイドの“Migrate from OpenClaw”です。OpenClaw → Hermesの移行手順の出典です。 ↩↩

  6. Nous Research、Hermes Agentリファレンスドキュメントの“CLI Commands Reference”です。本記事で説明するすべてのトップレベルCLIコマンドの一次資料です。対象には、hermes chat、hermes model、hermes gateway、hermes setup、hermes auth、hermes status、hermes cron、hermes webhook、hermes doctor、hermes dump、hermes logs、hermes config、hermes pairing、hermes skills、hermes honcho、hermes memory、hermes acp、hermes mcp、hermes plugins、hermes tools、hermes sessions、hermes insights、hermes claw、hermes profile、hermes completion、hermes update、hermes uninstallが含まれます。本記事のサブコマンドのフラグ、オプションの説明、認証情報プールの動作、ログのフィルタリング構文、OpenClaw移行用フラグ、profile管理コマンド、サービスのインストールコマンドは、すべてこのページに基づいています。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  7. Nous Research、Hermes Agent入門ガイドの“Installation”です。1行のインストーラーコマンド、インストーラーの動作(前提条件、対応プラットフォーム、Termuxの自動検出、Windows/WSL2の要件)、追加オプションの一覧表、手動インストールの手順、検証用コマンドの一次資料です。 ↩↩↩↩↩↩↩↩↩

  8. Nous Research、“CLI Commands Reference”です。特にhermes dumpのセクションをご覧ください。コマンドの出力形式(ヘッダー、環境、識別情報、モデル、ターミナル、APIキー、機能、サービス、ワークロード、設定の上書き)と、診断情報の共有という想定用途が説明されています。 ↩

  9. Nous Research、Hermes Agentリファレンスドキュメントの“Slash Commands Reference”です。本記事に記載するすべてのスラッシュコマンド、COMMAND_REGISTRYのアーキテクチャ、CLIとメッセージングでの違い、動的なskillスラッシュコマンド、config.yamlのクイックコマンド、前方一致の動作、メッセージング専用コマンド(/status、/sethome、/approve、/deny、/update、/commands)の一次資料です。 ↩↩↩↩↩↩↩↩↩↩

  10. Nous Research、Hermes Agentユーザーガイドの“Tools & Toolsets”です。ツールのカテゴリ概要、toolsetの利用コマンド、7つのターミナルバックエンド(local、docker、ssh、singularity、modal、daytona、vercel_sandbox)、コンテナ設定(cpu、memory、disk、persistent)、コンテナのセキュリティ強化、バックグラウンドプロセス管理API、sudo対応の一次資料です。 ↩↩↩↩↩↩↩↩↩↩

  11. Nous Research、Hermes Agentユーザーガイドの“Skills System”です。段階的な情報開示、SKILL.mdの形式、プラットフォーム固有のskill、条件付きの有効化(fallback_for_toolsets、requires_toolsets、fallback_for_tools、requires_tools)、skill_manageを通じたエージェントによるskill管理、skillハブのコマンドとソース一覧(official、skills-sh、well-known、github、clawhub、claude-marketplace、lobehub)、セキュリティスキャンと信頼レベル、外部skillディレクトリの一次資料です。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  12. Nous Research、Hermes Agentユーザーガイドの“Persistent Memory”です。MEMORY.md / USER.mdの文字数制限、固定スナップショットのパターン、メモリツールの操作(add、replace、remove)、保存する情報と保存しない情報の判断基準、メモリとセッション検索の比較、外部メモリプロバイダーの一次資料です。タグv2026.9.24の関連するMemory Providersページ(9行目)には、「Hermes Agentには7つの外部メモリプロバイダープラグインが同梱されています」とあり、「さらに多くのプラグイン(Hindsightなど)をプラグインカタログから入手できます」と補足されています。同タグのplugins/memory/には、byterover、holographic、honcho、mem0、openviking、retaindb、supermemoryが含まれています。 ↩↩↩↩↩↩↩↩

  13. Nous Research、Hermes Agentユーザーガイドの“Personality & SOUL.md”です。SOUL.mdの動作(HERMES_HOMEに配置され、上書きされることはなく、システムプロンプトのスロット#1に入り、組み込み前にセキュリティスキャンを受けます)、SOUL.mdとAGENTS.mdの違い、組み込みのパーソナリティ一覧(helpfulからhypeまでの14種類)、config.yamlでのカスタムパーソナリティ、/personalityのオーバーレイパターン、プロンプトスタック全体の組み立て順序の一次資料です。 ↩↩↩↩↩↩↩↩↩↩↩↩

  14. Nous Research、Hermes Agentのガイドとリファレンスにある“Use MCP with Hermes”およびMCP Config Referenceです。config.yaml内のmcp_servers:設定形式と、そのcommand、args、envフィールドの出典です。 ↩

  15. Hermes Agent v0.8.0 Release Notes。2026年4月8日。バックグラウンドプロセスの自動通知、Nous PortalでのMiMo v2 Proの無料提供、プラットフォームをまたぐ実行中の/model切り替え、Google AI Studioのネイティブプロバイダー、Qwen OAuth、非アクティブ時間に基づくタイムアウト、Slack/Telegramの承認ボタン、MCP OAuth 2.1 PKCE、ログの一元管理、プラグインシステムの拡張が含まれます。 ↩↩↩↩↩

  16. Hermes Agent v0.9.0 Release Notes。2026年4月13日。ローカルWebダッシュボード、Fast Mode(/fast)、BlueBubbles経由のiMessage、WeChat + WeCom、Termux/Android、バックグラウンドプロセスの監視(watch_patterns)、xAI + Xiaomi MiMoのネイティブプロバイダー、差し替え可能なcontext engine、統一されたプロキシ対応、セキュリティ強化(パストラバーサル、シェルインジェクション、SSRF、RCEの修正)、hermes backup/hermes import、/debug + hermes debug shareが含まれ、16のプラットフォームに対応しています。コミット487件、マージ済みPR269件、貢献者24人です。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  17. Hermes Agent v0.12.0 Release Notes。2026年4月30日。「Curatorリリース」です。自律的にバックグラウンドで動くCuratorが、gatewayのcronティッカー上で、デフォルトでは7日周期でskillライブラリを評価し、不要な項目を削除して統合します。自己改善ループも強化され、ルーブリックに基づく評価、既存項目の積極的な更新を優先する方針、適切なランタイム継承、メモリとskillに用途を限定したtoolsetが導入されています。新たな推論プロバイダーはGMI Cloud、Azure AI Foundry、MiniMax OAuth、Tencent Tokenhubの4つです。LM Studioは正式なサポート対象に昇格しました。リモートのモデルカタログマニフェストは、リリースを待たずに自動更新されます。新たなメッセージングプラットフォームはMicrosoft Teams(19番目、差し替え可能なgatewayアーキテクチャ経由)とTencent Yuanbao(18番目、テキストとメディアにネイティブ対応)の2つです。PKCE OAuth経由のSpotifyネイティブ連携と同梱skill、通話と文字起こし用のGoogle Meetプラグイン、ローカルTTSプロバイダーのPiperが追加されています。ComfyUI v5 + TouchDesigner-MCPはデフォルトで同梱されます。新たなskillはHumanizer、claude-design、design-md、airtableです。CLIには、hermes -zの単発実行モード、hermes update --checkによる事前確認、/reload-skillsスラッシュコマンド、差し替え可能な処理中インジケーターのスタイルが追加されています。遅延初期化により、TUIのコールドスタート時間を約57%短縮しています。セキュリティ面では、機密情報のマスキングがデフォルトで無効になり、実行後に復旧できないコマンドには厳格なブロックリストが適用されます。v0.11.0以降の実績は、コミット1,096件、マージ済みPR550件、コミュニティ貢献者213人です。v2026.4.30リリースタグもご覧ください。 ↩↩↩

  18. Hermes Agent v0.13.0 Release Notes。2026年5月7日。「Tenacityリリース」です。マルチエージェントのカンバンボードに、ハートビート、タスクの再回収、ゾンビ検出、ハルシネーション検査、タスクごとのmax_retries、複数プロジェクト用のボードが追加されています。/goalスラッシュコマンドでは、ターンをまたいで目標を固定でき(Ralphループの基本機能)、ターン数の上限も設定できます。video_analyzeツールはGeminiを優先し、互換性のあるマルチモーダルモデルへ拡張できます。xAI Custom Voices TTSプロバイダーは音声クローンに対応しています。国際化はzh-Hans、ja、de、es、fr、uk、trの7言語に対応しています(CLI + gatewayメッセージ。ドキュメントはzh-Hansのみです)。汎用のenv_enablement_fn / cron_deliver_env_varプラグインフックを備えた、差し替え可能なアダプターパターンにより、Google Chatが20番目のメッセージングプラットフォームとして追加されました。IRCとMicrosoft Teamsも同じパターンへ移行しています。サードパーティー製プロバイダーを差し替え可能にするため、ProviderProfile抽象基底クラス(ABC)とplugins/model-providers/が導入されています。gatewayの再起動、/update、ソースファイルの再読み込み後も、セッションが自動的に再開されます。Checkpoints v2は単一ストア構成に書き直され、不要データの実削除とディスク使用量の保護機構を備え、孤立したシャドウリポジトリが残らなくなりました。P0のセキュリティ課題8件に対処しています。機密情報のマスキングをデフォルトで有効化し、DiscordのギルドをまたぐDMの制限回避を修正(CVSS 8.1、ロールの許可リストをギルド単位に限定)、WhatsAppでは未知の相手をデフォルトで拒否して自分自身とのチャットには応答しないようにしています。さらに、MCP OAuthの認証情報保存時のTOCTOU、CLIの認証情報書き込み処理におけるauth.jsonのTOCTOUに対処し、ハイブリッドルーティング時のブラウザーによるクラウドメタデータへのアクセスにSSRF対策の最低限の保護を適用しています。cronでは組み立て済みプロンプト(skillの内容を含む)をスキャンしてプロンプトインジェクションを検出し、hermes debug shareではアップロード時にログ内の機密情報をマスキングします。そのほかの主な変更点として、Python/JSON/YAML/TOMLの書き込み後のリント、cronのno_agentによるスクリプトのみのウォッチドッグモード、Slack/Telegram/Mattermost/Matrix/DingTalkの各プラットフォームの許可リスト、MCPの強化(SSEトランスポート、OAuthの転送、画像結果のMEDIAタグ化)があります。v0.12.0以降の実績は、コミット864件、マージ済みPR588件、変更ファイル829件、コミュニティ貢献者295人、クローズした課題282件(P0が13件、P1が36件)です。 ↩↩↩↩↩↩↩↩↩↩↩↩

  19. Hermes Agent v0.14.0 Release Notes。2026年5月16日。「Foundationリリース」です。v0.13.0以降の実績は、コミット808件、マージ済みPR633件、変更ファイル1,393件、追加行165,061行、クローズした課題545件(P0が12件、P1が50件)、コミュニティ貢献者215人です。100万トークンのコンテキストに対応したgrok-4.3を利用できるSuperGrok OAuth、hermes proxy、x_search、PyPIパッケージ化、依存関係の遅延読み込み、セッション間で共有する有効期間1時間のClaudeプロンプトキャッシュが追加されています。起動は約19秒速くなり、ブラウザーのCDP呼び出しは180倍高速化しています。LINEとSimpleX Chatの追加で、対応するメッセージングプラットフォームは22になりました。さらに、/handoff、ネイティブの確認用ボタン、Discord履歴の補完、生のピクセルデータを使うvision_analyze、各ターンのファイル変更検証結果を示すフッター、LSPによるセマンティック診断、統一されたvideo_generate、cua-driverのcomputer_use、OSC8リンク、Zed ACP Registry対応、OpenRouter Pareto Codeルーター、NovitaAI、Codex app-serverランタイム、huggingface/skills、プラグインのctx.llm、tool_override、Brave/DDGS検索、危険なコマンドへの対策強化、/subgoal、Qwen Cloudへの名称変更、ネイティブWindowsベータ版、全16ロケールへの対応、ドキュメントとテストの広範な更新が含まれます。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  20. Hermes Agent v0.16.0 リリースノート、「The Surface Release」、タグ v2026.6.5、公開日時は2026-06-06T00:55:58Z(リリースタグの日付は2026年6月5日)です。2026年6月8日時点の最新リリースです。ネイティブの Hermes Desktop が新たに登場しました(Electron、macOS/Linux/Windows 対応。安全な WebSocket 経由でリモート gateway に接続し、OAuth またはユーザー名/パスワードで認証。profile ごとのリモートホスト、profile をまたぐ @session リンク、型付き i18n と display.language による簡体字中国語 UI に対応)。Web ダッシュボードは本格的な管理パネルへと拡張されました(MCP カタログの切り替え、認証情報の管理、webhook/hook の作成、メモリ設定、gateway の制御、更新前チェックと Debug Share を備えた System ページ、Channels ページ。セルフホスト型 OIDC と hermes dashboard register を含む、差し替え可能な認証方式に対応)。新しいコマンドと操作機能として、/undo [N]、デフォルトインターフェースの設定(cli/tui、--cli)、TUI の /model と Sessions オーバーレイ、hermes portal、hermes prompt-size、hermes sessions optimize が追加されました。新しいモデルは deepseek-v4-flash、MiniMax-M3(1M コンテキスト)、qwen3.7-plus、gemini-3.5-flash です。xAI Grok の OAuth、あいまい検索対応の選択機能、1時間ごとのカタログ更新にも対応しました。skill 関連では、デフォルトセットのスリム化、environments: による関連性の判定、デフォルトで信頼される tap としての NVIDIA/skills、ツールの段階的な開示、MCP で OAuth が誤って成功と判定される問題の修正が含まれます。セキュリティ面では、CVE-2026-48710(Starlette BadHost)への対応としてバージョンを ≥1.0.1 に固定し、SSRF チェックをイベントループ外へ移動しました。さらに、サブプロセスの環境変数から Bedrock bearer token を除去し、bws_cache.json の読み取りを保護し、危険なパターンに docker restart/stop/kill を追加し、不可視 Unicode 文字を無害化しています。P0 を2件、P1 を62件クローズしました(うち16件はセキュリティタグ付き)。リリースノートの宣伝的な表現(PR/コミット数、「1週間前には、ここにあるものは何も存在しなかった」など)は除外し、タグに紐づく具体的な機能とバージョンの事実のみを記録しています。今回のセッションでは2026年6月8日に検証しました。 ↩↩↩↩↩↩↩↩

  21. Hermes Agent v0.17.0 リリースノート、「The Reach Release」、タグ v2026.6.19、2026年6月19日。2026年6月21日時点の最新リリースです。メッセージングでは、Photon Spectrum 経由の iMessage(デバイスコードによる OAuth、hermes photon login、Mac リレーは不要)、公式 WhatsApp Business Cloud API アダプター(ブリッジプロセスを置き換え)、SimpleX のグループ、ネイティブ添付ファイル、テキストのバッチ処理、自動承認に対応し、Raft プラットフォームプラグインを同梱しました。モデル/プロバイダーでは、z-ai/glm-5.2(1M コンテキスト)、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra、grok-composer-2.5-fast(xAI OAuth、200k コンテキスト)に対応しました。xAI のデフォルトは grok-build-0.1 に変更されています。Anthropic の適応型モデルは新しい思考処理の仕様を使用します(reasoning フィールドはありません)。CLI/スラッシュコマンドでは、/version、/billing、hermes photon login、hermes curator run --consolidate(オプトイン)、hermes model の GUI、profile の複製が追加されました。Desktop では、バックグラウンドのサブエージェント監視ウィンドウ(delegate_task(background=true))、Composer のモデル選択、割り当て変更可能なショートカット、OS ネイティブ通知、スレッドごとの下書き、VS Code Marketplace のテーマ、日本語と繁体字中国語の UI に対応しました。ダッシュボードでは、本格的な profile ビルダー、グローバルな profile 切り替え、セキュリティスキャンを備えた Skills Hub の刷新、Automation Blueprints、安全なログイン(OAuth による保護下で401を返す処理)が含まれます。skill/ツール関連では、image_generate による複数プロバイダーでの画像から画像への編集、memory の operations によるアトミックなバッチ処理、並列レビュー用の simplify-code skill が追加され、write_mode は真偽値の write_approval に置き換えられました。アーキテクチャでは、バックグラウンドのサブエージェント(ハンドルを即座に返し、結果を1つのターンとして再投入)、ツール呼び出し中の確認を行う MCP の elicitation ハンドラー、ターン間での後から接続された MCP ツールの公開、差し替え可能な CronScheduler と Chronos のマネージド cron、Managed スコープ(/etc/hermes で管理者が固定)、Gateway-Gateway リレーが導入されました。セキュリティ面では、シェルエスケープによる拒否リストの回避を修正し、承認モジュールが欠落した場合と独自ポリシーを持つ gateway アダプターで、安全側に処理を拒否するようにしました。cron のジョブスクリプトの環境変数を無害化し、デバッグダンプ内のシークレットを伏せ、公開ステータスからホストのメタデータを除外しています。MCP の stdio で情報流出パターンを検査し、CVE 対応のため urllib3 と PyJWT を更新しました。リリースの宣伝的な表現(コミット/PR 数)は除外しています。今回のセッションでは2026年6月21日に検証しました。 ↩↩↩↩↩↩↩↩↩↩↩

  22. Hermes Agent v0.18.0 リリースノート(タグ v2026.7.1)、2026年7月1日 — 「The Judgment Release」。優先度の高いバックログを一掃しました(すべての P0/P1 をクローズし、12日間で約692件に対応)。Mixture-of-Agents をすべてのインターフェースで正式なモデル選択肢として選べるようになり、各参照モデルの出力全文を個別のラベル付きブロックに表示し、回答をリアルタイムでストリーミングします。/goal の完了条件(エージェントがプロジェクトのチェックを実行し、自身の作業を検証)、/learn コマンド(内容を説明するだけで再利用可能な skill に変換し、CONTRIBUTING.md にも自動で準拠)、/journey のメモリ/skill の視覚的なタイムライン(編集機能とデスクトップのメモリグラフ付き)、バックグラウンドでのサブエージェントへの並列分散(複数の委任タスクを同時実行)、Desktop Projects(プロジェクト/リポジトリ/レーンのモデル)、処理中のタスクの完了を調整しながらゼロまでスケールダウンする gateway、Google Vertex AI 対応(GCP サービスアカウント経由の Gemini、OAuth2 トークンの自動更新)、$EDITOR を使用する /prompt コマンドが追加されました。今回のセッションでは2026年7月1日(PST)に GitHub のリリースページと照合し、v0.18.0 が最新リリースであることを確認しました。 ↩↩↩↩↩↩↩↩↩↩↩

  23. Hermes Agent v0.20.5 リリースノート(タグ v2026.8.19、記載上のリリース日は8月19日、公開日は2026年8月21日。2026年8月24日に GitHub API 経由で取得。prerelease: false)。対象期間の説明の全文訳:「約1,250ファイルにわたる約746コミット(+111,500 / -20,701)、約323件のマージ済み PR には、Bot Mode のグループルームのスレッド、折りたたみ可能な会話要約、ブロブ型の顔アバター、ドラッグ&ドロップによる PDF/ファイル添付が含まれます。さらに、キー不要の Web 層(5ベンダーの無料枠を順番に利用し、リング方式でフェイルオーバー。新規インストール時からキーなしで Web 検索が可能)、CLI の一連の改善(あいまい検索対応の /model 選択、Ctrl+P コマンドパレット、/status の情報拡充)、Composio の評価結果を受けた実行規律の強化と実行時の停止を防ぐ保護機構、hermes update の実行記録とフリートの --plan 検証、hermes worktree list/prune、認証不要の opencode-free プロバイダー、複数の質問による確認、デスクトップのパフォーマンス改善(描画を優先する Bot Mode のハイドレーション、コンポジターで動作するスピナー、両レンダラーへの React Compiler の導入)、cron ジョブの永続メモリとジョブごとの推論 effort 設定が含まれます」。このリリースでは、「この期間の変更を精選した完全なリリースノートは v0.21.0 とともに公開します」と重ねて述べています。 ↩↩↩↩↩↩↩↩↩↩↩

  24. タグ v2026.8.31 のターミナルバックエンド(ガイド v1.17 向けに再検証済みです。agent/terminal_env_registry.py は v2026.8.31 版とバイト単位で一致し、tools/terminal_tool.py の docstring に記載された事実にも変更はありません。tools/environments/ には引き続き同じ7つのバックエンドモジュールがあり、現在は path_utils.py ヘルパーも追加されています)。tools/terminal_tool.py のモジュール docstring の該当箇所を訳すと、「ローカル、Docker、Modal、SSH、Singularity、Daytona、Vercel Sandbox の各環境でコマンドを実行するターミナルツール」です。また、環境選択リストの vercel_sandbox 項目には「Vercel Sandbox のクラウドサンドボックスで実行」とあります。このタグには、バックエンドモジュール tools/environments/vercel_sandbox.py が、daytona.py、docker.py、local.py、modal.py、singularity.py、ssh.py とともに存在します。このタグの README には、「7つのターミナルバックエンド:ローカル、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox」とあります。ツールと toolset のドキュメントページ(このタグのソースは website/docs/user-guide/features/tools.md)では、表内で vercel_sandbox を「Vercel Sandbox のクラウド microVM」と説明し、用途を「スナップショットによるファイルシステムの永続化を備えたクラウド実行」としています。設定コメントとして # or: docker, ssh, singularity, modal, daytona, vercel_sandbox を掲載し、次のように説明しています。「認証には VERCEL_TOKEN、VERCEL_PROJECT_ID、VERCEL_TEAM_ID の3つすべてを使用します。…対応ランタイムは node24、node22、python3.13 です。Hermes はリモートワークスペースのルートとして、デフォルトで /vercel/sandbox を使用します」。v2026.8.31 の tools/environments/ パッケージには、共通の基盤処理(BaseEnvironment ABC を含む base.py、file_sync.py、modal_utils.py、managed_modal.py)も含まれています。パッケージの docstring では、マネージド Modal を8つ目のバックエンドとはせず、Modal の1つのモードとして扱っています。「Modal には、直接利用するモードと Nous が管理するモードもあり、terminal.modal_mode で選択します」。 ↩↩↩

  25. タグv2026.8.31時点のメッセージングプラットフォーム数です(ガイドv1.17向けに再検証済み。v2026.8.31と同じく、ドキュメントの表は28行、Platform列挙型のメンバーは24個、アダプターディレクトリは22個です)。Messaging Gatewayのドキュメントページ(同タグのソースはwebsite/docs/user-guide/messaging/index.md)には、28行の「プラットフォーム比較」表があります:Telegram、Discord、Slack、Google Chat、WhatsApp、WhatsApp Cloud API、Signal、SMS、Email、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、WeCom Callback、Weixin、BlueBubbles、Photon(iMessage)、QQ、Yuanbao、Microsoft Teams、LINE、ntfy、Raft、IRC、Buzz、SimpleXです。gateway/config.pyでは、class Platform(Enum)に24個のメンバー(local、telegram、discord、whatsapp、whatsapp_cloud、slack、signal、mattermost、matrix、homeassistant、email、sms、dingtalk、api_server、webhook、msgraph_webhook、feishu、wecom、wecom_callback、weixin、bluebubbles、qqbot、yuanbao、relay)を明示的に定義し、次のように説明しています。「プラグインのプラットフォームでは、_missing_()が必要に応じて作成する動的メンバーを使用します。そのため、この列挙型を変更せずにPlatform("irc")が動作します。」同タグのplugins/platforms/ツリーには、22個のアダプターディレクトリがあります:a2a buzz dingtalk discord email feishu google_chat homeassistant irc line matrix mattermost ntfy photon raft simplex slack sms teams telegram wecom whatsapp。各プラットフォームの説明として、ntfyのページには次の記述があります(原文からの引用を翻訳)。「ntfyは、HTTPベースのシンプルなパブリッシュ/サブスクライブ型通知サービスです。ntfy.shの無料公開サーバーでも、セルフホストしたインスタンスでも動作します……ntfyのモバイルアプリでトピックを購読し、そのトピックにメッセージを送ってエージェントと会話すると、スマートフォンで応答を受け取れます。」Buzzのページには次の記述があります(原文からの引用を翻訳)。「Buzzアダプターは、HermesをBuzzコミュニティに接続し、Buzzのチャンネル(またはDM)とエージェントの間でメッセージを中継します。Buzzは、Blockが開発した、Nostrプロトコルを基盤とするオープンソースの人間とエージェントの協働プラットフォームです。送信時はシェル経由でbuzz CLIバイナリを呼び出し……受信時はネイティブのNostr WebSocketサブスクリプションを使用します。」両ページには、「hermes gateway setupを実行して……を選択すると、ガイドに沿って設定できます」とあります。 ↩↩↩

  26. タグv2026.8.31時点のプロバイダー数です(ガイドv1.17向けに再検証済み。v0.21.0では、v2026.8.31の静的エントリー38件/プラグインディレクトリ37個/ドキュメントの表41行から、これらの数が変更されました)。hermes_cli/models.pyでは、CANONICAL_PROVIDERS: list[ProviderEntry]に39件の静的エントリー(nous、fireworks、openrouter、moa、novita、lmstudio、anthropic、openai-codex、openai-api、alibaba、xai-oauth、xiaomi、tencent-tokenhub、tencent-tokenplan、nvidia、copilot、copilot-acp、huggingface、gemini、vertex、deepseek、xai、zai、kimi-coding、kimi-coding-cn、stepfun、minimax、minimax-oauth、minimax-cn、ollama-cloud、arcee、gmi、kilocode、opencode-zen、opencode-go、bedrock、azure-foundry、ai-gateway、qwen-oauth)を宣言しています。その後には、「providers/に登録されていて上記のリストにまだ含まれていないプロバイダーを、CANONICAL_PROVIDERSに自動追加します。plugins/model-providers//を追加するだけで、モデル選択画面に新しいプロバイダーが表示されます」というコメントがあります。このループがスキップする認証タイプは、oauth_device_code、oauth_external、external_process、aws_sdk、copilot、vertexのみで、変更はありません。同タグのplugins/model-providers/ツリーには39個のプロバイダーディレクトリがあります(v0.21.0の開発期間中にnebius-token-factoryとrouterが追加されました)。静的エントリーのない9個(actual、alibaba-coding-plan、commandcode、deepinfra、meta-ai、nebius-token-factory、opencode-free、router、upstage)は、いずれも認証タイプがapi_keyになります。このうち7個はauth_type="api_key"を明示的に宣言しており、新しいプラグイン2個も含まれます。commandcodeとopencode-freeは、providers/base.pyからauth_type: str = "api_key"を継承しています。AIプロバイダーのドキュメントページ(同タグのソースはwebsite/docs/integrations/providers.md)の表には、名前付きプロバイダー45件と「カスタムエンドポイント」の行が掲載されています(v2026.8.31以降に追加された行は、Ramp Router、Nebius Token Factory、Tencent TokenPlan、Alibaba Cloud(Token Plan)です。36に引用しています)。新しく追加した一覧表の行にある環境変数名、プロバイダーのスラッグ、エイリアス、認証に関する注記は、すべてその表から引用しています。これには、「OpenCode Free | キー不要 — APIキーやアカウントは必要ありません(プロバイダー:opencode-free、エイリアス:free、opencode_free)。hermes modelまたは/model freeで選択します。リクエストは匿名で送信されます」、「Google Vertex AI | ……サービスアカウントのJSONまたはADC経由のOAuth2、GCP課金」、「AWS Bedrock | ……boto3経由の標準AWS認証情報チェーン」、「CommandCode | ……GOAT/Pro/Max/Providerプランで利用できます(1ドルのGoプランは対象外です。APIへのアクセスがありません)」が含まれます。Meta AIの行は、同じページの正式対応プロバイダー向けAPIキーの説明部分に基づいています。「Meta Model API(Muse Sparkファミリー)……hermes chat --provider meta-ai --model muse-spark-1.2……必要な環境変数:MODEL_API_KEY」とあります。Cerebrasは、このページの「その他の互換プロバイダー」表(https://api.cerebras.ai/v1、「ウェハースケールチップによる推論」)にのみ掲載されているため、正式対応プロバイダーとしてではなく、カスタムエンドポイントの行に記載しています。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  27. タグ v2026.8.31 時点の CLI の機能一覧です(ガイドv1.17向けに再検証済みです。引用したグローバルオプションのヘルプ文字列と _BUILTIN_SUBCOMMANDS に関するすべての記述は v2026.8.31 から変わっていません。frozensetは73項目で完全に同一です。一方、hermes_cli/_parser.py の変更は hermes chat 内に限られ、40 に記載しています)。グローバルオプションとそのヘルプ文字列の出典は hermes_cli/_parser.py です。--in(「開始または再開する前にDIRへ移動します。’–resume latest’ または -c と組み合わせると、DIRのワークスペースで最新のセッションが選択され、セッションはDIRにとどまります(記録済みのcwdへの復元をスキップします)。」)、--ignore-user-config(「~/.hermes/config.yamlを無視して組み込みの既定値を使用します(.env内の認証情報は引き続き読み込まれます)」)、--ignore-rules(「AGENTS.md、SOUL.md、.cursorrules、メモリ、事前読み込みされたskillの自動挿入をスキップします」)、--tui(「従来のREPLの代わりに新しいTUIを起動します」)、--cli(「従来のprompt_toolkit REPLを強制的に使用します(display.interface=tuiより優先されます)」)、--dev(「–tuiと併用すると、tsx経由で TypeScript のソースを実行します(distのビルドをスキップします)」)、--version/-V(「バージョンを表示して終了します」)があります。hermes_cli/_startup_fast.py が高速処理するのは argv in (["--version"], ["-V"]) の場合だけで、hermes_cli/main.py の _BUILTIN_SUBCOMMANDS frozensetに version という項目はありません。CLI コマンドリファレンス には hermes --version(「バージョン情報を表示します」)が記載されており、hermes version はありません。コマンドの説明は、このタグの hermes_cli/main.py と hermes_cli/subcommands/*.py にあるパーサーの help= 文字列に基づき、ドキュメントのトップレベルコマンド表とも照合しています(例:approvals は「承認プロンプト用ツール(履歴を分析して許可リストの候補を作成します)」、pause は「緊急停止:cron/kanbanのディスパッチとgatewayの新規ターンを一時停止します」、sync は「Skill Sync – デバイス間やチーム内でskillを同期します」、verify は「プロジェクトの実行手順を検出し、スモークテストを行います」、login は「非推奨です。認証情報の管理には hermes auth、プロバイダーの選択には hermes model、全体のセットアップには hermes setup を使用してください。」)。hermes update --plan は hermes_cli/subcommands/update.py にあり、説明は「更新計画を表示し、何も変更せずに終了します。インストールの種類(git/docker/nix)、すべてのprofileで実行中の各Hermesサービスとそのスーパーバイザーおよび実行中のコードのバージョン、各サービスの再起動方法を表示します。読み取り専用なので、稼働中のフリートでも安全に使用できます。」となっています。_BUILTIN_SUBCOMMANDS に fleet コマンドは存在しません。hermes worktree は hermes_cli/main.py に登録されています(ヘルプ:「蓄積したgit worktreeとマージ済みブランチを監査し、不要なものを削除します」)。list(別名は ls、audit。「すべてのツリーを経過時間、サイズ、判定、理由で分類します(既定の動作)」)、prune(「安全に削除できるツリーを削除し、完全にマージ済みのローカルブランチを削除します」)、--repo、--dry-run(「何も変更せずに計画を表示します」)、--trees-only(「worktreeのみを削除し、ローカルブランチはそのまま残します」)、--branches-only(「マージ済みのローカルブランチのみを削除し、worktreeはそのまま残します」)を備えています。スラッシュコマンド /worktree の実装は hermes_cli/cli_commands_mixin.py の _handle_worktree_command です(構文ブロック:/worktree、/worktree new [name]、/worktree list、/worktree prune [--dry-run])。CLI ユーザーガイド の「Worktreeのクリーンアップ」セクションには、「セッション内では、/worktree prune [--dry-run] で同じ処理を行えます(セッションが実行されているツリーには一切変更を加えません)。」と補足されています。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  28. タグ v2026.8.31 時点のNous Portalコマンドです(ガイドv1.17向けに再検証済みで、hermes_cli/portal_cli.py は v2026.8.31 版とバイト単位で同一です)。このタグのREADME の「API キーを集める手間を省く – Nous Portal」セクションには、「新規インストール後にコマンドを1つ実行するだけです:hermes setup --portal … これにより OAuth 経由でログインし、プロバイダーにNousを設定して、Tool Gatewayを有効にします。何が接続されているかは、hermes portal info でいつでも確認できます。」とあります。hermes_cli/portal_cli.py には portal(ヘルプ:「Nous Portalをセットアップします(ログイン、モデル選択、Tool Gateway)。portal info もご覧ください」)が登録されており、login(「Nous Portalにログインしてセットアップします(既定の動作。初期設定を一度に行います)」)、info(「Portalの認証とTool Gatewayのルーティングの概要を表示します」)、open(「既定のブラウザーでPortalのサブスクリプションページを開きます」)、tools(「Tool Gatewayのツール一覧と、Nous経由でルーティングされるツールを表示します」)を備えています。また、コードのコメントには「status は、後方互換性のために info の非表示の別名として残しています。」とあります。Tool Gatewayのドキュメントページ には hermes setup --portal # Fresh install: Nous OAuth + set Nous as provider + turn on the Tool Gateway in one go と hermes portal info # Portal auth + Tool Gateway routing summary が掲載されています。同じタグの CLI コマンドリファレンスには、引き続き hermes portal [status|open|tools] と記載されています。 ↩↩↩

  29. GitHub のcompare API で NousResearch/hermes-agent の v2026.8.19...main を2026年8月26日に取得した結果は、ahead_by: 1104、behind_by: 0 でした。リリースの API では、v2026.8.19(Hermes Agent v0.20.5、公開日時は2026-08-21T12:16:39Z)が最新のタグとして掲載されており、そのリリースノートには「この期間の変更を整理した完全なリリースノートはv0.21.0で公開し、v0.20.0以降のすべての変更を記載します。」とあります。2026年8月27日に新しいタグで再確認したところ、v2026.8.27...main の結果は ahead_by: 0、behind_by: 0、status: identical でした。この時点で main はv0.20.6のタグと完全に一致しています。 ↩↩

  30. Hermes Agent v0.20.6リリースノート(タグは v2026.8.27、記載されたリリース日は8月27日、公開日時は2026-08-27T12:06:53Zです。2026年8月27日に GitHub の API 経由で取得しました。prerelease: false)。位置づけについての原文記述は次のとおりです。「パッチリリースです。このタグは、v0.20.5以降にマージされた約525件のPRを、下流の利用者(Docker イメージ、ホスト環境へのデプロイ、新規インストール)向けに、タグ付きの安定版リリースとしてまとめたものです。」対象期間についての原文記述は次のとおりです。「v0.20.5(v2026.8.19、8月21日にタグ付け)以降、この期間には約1,557ファイルにわたる約1,313件のコミット(+177,113 / -21,682)が取り込まれ、約525件のPRがマージされました。内容には、同意を得たうえで実際のprofileを使うブラウジング(ローカルでのブラウジングに既定のChromium profileを使用し、Windowsでは承認を得てから閉じるフローに対応)、デスクトップBrowser専用のOSウィンドウと管理された SSH リモート更新エンジンおよびフリートのprofileレール、リモート MCP カタログの大幅な拡充(Cloudflare、Grafana Cloud、Better Stack、Railway など、稼働を確認したベンダーホスト型サーバー50以上)、web_search/web_extractのTTL付き結果キャッシュ、lean-tail圧縮の既定化、語幹処理に対応した複数クエリのtool_search、保存済みシークレットに対する任意のOSキーチェーン暗号化(macOS Keychainの確認が起動のたびに表示されることはなくなりました)、プロセスツリーを強制終了する代わりに制御ソケット経由でgatewayを一時停止するアップデーター、イメージ/パッケージ管理のインストール環境で安全でないインプレース更新を拒否する処理(#91277 フェーズ3)、cronの永続的なインシデント確認応答とコードのバージョン不一致によるエラーの明確化、Slackのリンク展開制御、共有の Docker コンテナID、差し替え可能なターミナル環境バックエンド、各モデル選択画面への新モデル追加(GLM-5.3-Flash、MiniMax M3 free、MiniMax H3 Max video)が含まれます。」リリースでは、次の点も繰り返し述べられています。「この期間の変更を整理した完全なリリースノートはv0.21.0で公開し、v0.20.0以降のすべての変更を、ハイライト、機能分野、すべての貢献者のクレジットとともに記載します。この期間の変更に省略はありません。」 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  31. タグ v2026.8.31 における圧縮について、ガイド v1.17 向けに v2026.8.31 で再検証しました。tail_mode: str = "lean"、("legacy", "lean") のガード、agent_init のデフォルト値 "lean"、設定バージョン17への移行、後述の補助設定に関する古いコメントの注記は、いずれも新しいタグでも有効です(context_compressor.py には固定された要約ルートの再試行処理が追加されましたが、引用したデフォルト値には変更ありません)。agent/context_compressor.py の ContextCompressor.__init__ では tail_mode: str = "lean" がデフォルトです。コメントには「Lean tail mode(#compaction-v2):’lean’ = サイズを制限した直近の小さな末尾部分 + ユーザーメッセージを原文のまま含む要約セクション + 復元ポインター、’legacy’ = 0.20window の末尾部分(従来の動作)」とあり、ガードは self.tail_mode = tail_mode if tail_mode in ("legacy", "lean") else "lean" です。agent/agent_init.py は compression.tail_mode を読み取り、デフォルト値に "lean" を使います。そのコメントでは、両モードの保持量を具体的に示しています。「’lean’(デフォルト)は、復元ポインターの仕組みとともに、2.5%を基準に10K~25Kに制限した末尾部分を原文のまま保持します。… ‘legacy’ は #87326 より前の、0.20threshold に相当する末尾部分を原文のまま保持する動作に戻します。大きなコンテキストウィンドウや高いしきい値を使う構成では、圧縮のたびに100K~240Kトークンを抱え込むことになります」。設定ドキュメント(このタグでのソースは website/docs/user-guide/configuration.md)には、compression: ブロックに enabled、threshold: 0.50、threshold_tokens: null、target_ratio: 0.20、tail_mode: lean(v2026.8.31 での注記:「’lean’(デフォルト。末尾の2.5%を10K~25Kに制限して保持し、詳細なセッションログ + アンカーインデックス + session_search の復元ポインターを要約に含めます。これらはすべて補助要約モデルへの1回の呼び出しで生成され、圧縮後の保持トークン数は約3分の1になります)、または ‘legacy’(0.20×threshold の末尾部分を原文のまま保持)」)、protect_last_n: 20、protect_first_n: 3 が示されています。要約モデルの設定項目(model、provider、base_url)は auxiliary.compression 配下にあり、「compression.summary_model、compression.summary_provider、compression.summary_base_url を含む古い設定は、初回読み込み時に auxiliary.compression.* へ自動的に移行されます(設定バージョン17)。手動での操作は不要です」と説明されています。この移行処理は hermes_cli/config_migrations.py の _migrate_to_17 です(「バージョン16 -> 17:旧形式の compression.summary_* キーを削除します」)。コンテキスト圧縮の開発者向けページ(このタグでのソースは website/docs/developer-guide/context-compression-and-caching.md)では、表に tail_mode のデフォルト値を lean と記載し、「500Kトークンの実際のセッションでの結果:保持量は約162Kに対して約49K」「lean の末尾部分に含まれる古いツール結果は、復元ポインターを持つ1行のスタブに置き換えられます」と説明しています。また、要約モデルについて次の警告があります(v2026.8.31 時点)。「要約モデルのコンテキストウィンドウは、メインのエージェントモデルと少なくとも同じ大きさである必要があります。… そうでない場合、圧縮処理は中間のターンを要約なしで削除し、会話のコンテキストが警告なく失われます」。(上流には古い記述が1か所残っています。設定ページの「補助設定の完全なリファレンス」では、auxiliary.compression の項目に「コンテキスト圧縮のタイムアウト(compression.* の設定とは別)」というコメントがまだあります。移行コード、対話式の hermes model 補助モデル選択画面、同ページの圧縮セクションは、より新しく、互いに一致する情報源です。) ↩↩↩↩↩↩↩

  32. タグ v2026.8.31 におけるプラグイン対応のターミナルバックエンドについてです(ガイド v1.17 向けに再検証済み。agent/terminal_env_registry.py は v2026.8.31 版とバイト単位で同一です)。agent/terminal_env_registry.py のモジュール docstring には、次のように記載されています。「登録済みのプラグイン対応ターミナルバックエンドを一元管理するマップです。読み込み時にプラグインが PluginContext.register_terminal_environment_provider を通じて登録し、tools.terminal_tool._create_environment が参照します」「組み込みバックエンド名は予約されています。register_provider は既存名と衝突するプロバイダーを拒否するため、プラグインがリポジトリ内の docker/modal/… の実装を上書きすることはありません」。また、意図的に「ここでは有効なプロバイダーの解決を行いません。有効なバックエンドは、組み込みバックエンドとまったく同じように、TERMINAL_ENV / terminal.backend で指定されたものです」としています。BUILTIN_BACKEND_NAMES の frozenset には、7つのバックエンドと内部モード用エイリアス managed_modal が含まれます。local、docker、singularity、modal、managed_modal、daytona、vercel_sandbox、ssh です。新しいドキュメントページターミナル環境プロバイダーのプラグイン(このタグでのソースは website/docs/developer-guide/terminal-environment-plugin.md)には、次のように記載されています。「Hermes は、プラグインで拡張できるターミナルバックエンドを通じてシェルコマンドを実行します。組み込みバックエンド(local、Docker、Singularity、Modal、Daytona、Vercel Sandbox、SSH)は、コアリポジトリの tools/environments/ 配下にあります。サードパーティーのサンドボックスベンダーはプラグインとして統合します。独立したプラグインリポジトリを ~/.hermes/plugins/ 配下にインストールしてバックエンドを登録すると、config.yaml の terminal.backend で組み込みバックエンドと同じように選択できます」。このページでは、登録済みプロバイダーが担う機能(コマンドの振り分け、hermes setup のバックエンド選択画面、ダッシュボードのプローブ状態、hermes status/hermes doctor のチェック、システムプロンプトの環境ヒント、コンテナのパス/cwd の処理、シークレットの除去、セッションごとのサンドボックス分離)を表にまとめ、設計目標を次のように説明しています。「プロバイダーにこれらのフラグを宣言することで、『新しいバックエンドを分類処理のNか所目に追加し忘れた』という典型的な種類のバグを防ぎます。コアは各箇所で、ハードコードされた名前のリストではなくレジストリを参照します」。 ↩↩↩

  33. タグ v2026.8.31 での一括再検証です(ガイド v1.17)。ロケール:locales/ ツリーには17個のメッセージカタログがあります。en.yaml と16言語の翻訳(af、ar、de、es、fr、ga、hu、it、ja、ko、pt、ru、tr、uk、zh-hant、zh)で、v2026.8.27 と同一です。パーソナリティ:hermes_cli/personality.py の BUILTIN_PERSONALITIES には、helpful から hype まで同じ14項目が含まれています(helpful、concise、technical、creative、teacher、kawaii、catgirl、pirate、shakespeare、surfer、noir、uwu、philosopher、hype)。このファイルは v2026.8.27 版とバイト単位で同一です。このタグで変わった件数:静的な CANONICAL_PROVIDERS の項目数は39(以前は38)、plugins/model-providers/ のディレクトリ数は39(以前は37)です。26 と 36 をご覧ください。変わらなかった件数:Platform 列挙型のメンバーは24個(gateway/config.py のメンバー一覧は同一で、追加されたのは gateway の room_link_url フィールドのみです)、plugins/platforms/ のアダプターディレクトリは22個、ドキュメントのプラットフォーム比較表は28行です。_BUILTIN_SUBCOMMANDS には同じ73項目が含まれています(peer と worktree があり、version は引き続き存在せず、hermes approvals test をリリースノートで呼ぶ際の名前である approval-check もありません)。hermes_cli/_startup_fast.py と hermes_cli/portal_cli.py は v2026.8.27 版とバイト単位で同一です。 ↩↩↩↩

  34. タグ v2026.8.31 における補助モデルのルーティング(ガイド v1.17 向けに再検証済みです。新しいタグの "auxiliary" デフォルト設定ブロックには、同じスロット一覧、削除に関する注記、スロット以外の設定が含まれており、以下のドキュメントの引用も原文と一致しています)。設定ドキュメントのページ(タグ時点のソースは website/docs/user-guide/configuration.md)の原文引用(訳):「デフォルト(auxiliary.*.provider: "auto")では、Hermes はすべての補助タスクをメインのチャットモデル、つまり hermes model で選んだプロバイダーとモデルにルーティングします。使い始めるための設定は不要ですが、高価な推論モデル(Opus、MiniMax M2.7 など)では補助タスクによる追加コストが無視できない点にご注意ください」。同ページの「’auto’ がメインモデルを使う理由」という注記:「以前のビルドでは、アグリゲーター(OpenRouter、Nous Portal)のユーザーを、プロバイダー側の安価なデフォルトモデルに振り分けていました。これは意外な挙動でした。アグリゲーターのサブスクリプションに料金を支払っているのに、補助タスクの処理には別のモデルが使われていたのです。現在の auto は全ユーザーでメインモデルを使います。また、config.yaml のタスク別の上書き設定は引き続き優先されます」。Web 抽出については次のように説明しています:「(Web 抽出は補助タスクではありません。web_extract とブラウザーのスナップショットは、決定的な処理で長いコンテンツを切り詰め、read_file でページごとに読み出せるよう全文を保存します。LLM は関与しません)」。正式なスロット一覧は、タグ時点の hermes_cli/config_defaults.py にある "auxiliary" デフォルト設定ブロックです。vision、compression、skills_hub、approval、review、mcp、title_generation、memory_query_rewrite、tts_audio_tags、triage_specifier、kanban_decomposer、profile_describer、goal_judge、curator、monitor、background_review、moa_reference、moa_aggregator が含まれます(加えて、スロット以外の設定として transient_retries、free_only、openrouter_model、stream_only_base_urls があります)。各スロットには provider、model、base_url、api_key、timeout、extra_body、およびタスク別の reasoning_effort があります。同じファイルの削除に関する注記の原文引用(訳):「web_extract は補助 LLM を使用しなくなりました。ページは切り詰めて保存され、read_file へのポインターが付与されます(要約は行いません)。ブラウザーのスナップショットも同じ方式です。従来の auxiliary.web_extract.* ブロックはここから削除されました。ユーザーの config.yaml ファイルに既存の値が残っていても害はなく、無視されます」および「session_search は補助 LLM を使用しなくなりました(PR #27590 — 単一形式のツールが DB の内容を直接返します)」。このブロックに flush_memories キーは存在しません。各スロットの短い説明は、同じファイルのコメント(「Triage specifier — Kanban の Triage 列にある大まかな1行の説明を具体的な仕様に展開し、todo に移します。hermes kanban specify から呼び出されます」「Kanban decomposer — トリアージタスクを子タスクのグラフに分解し、説明に基づいて専門の profile に振り分けます。hermes kanban decompose と kanban の自動分解ディスパッチャーから呼び出されます」「Profile describer — profile が得意とすることを1〜2文で説明する文章を自動生成します。hermes profile describe <name> --auto とダッシュボードの自動生成ボタンから呼び出されます」「Goal judge — /goal 実行の最新の応答が目標・契約を満たしているか評価します」「Curator — skill の使用状況をレビューするためのフォークです」「Background review — メモリの保存や skill の修正が必要かを判断する、ターン終了後の自己改善用フォークです」)、設定ページの完全リファレンス内のコメント(「Gemini 3.1 TTS の非表示音声タグの挿入」「自動生成されるセッションタイトルです。言語が空の場合は会話の言語に従います」。auxiliary.title_generation.enabled: false でタイトルの自動生成を無効にできます)、および Kanban ドキュメントのページの設定表(「auxiliary.kanban_decomposer | タスクグラフを生成するモデルです(Decompose から呼び出されます)」「auxiliary.profile_describer | profile の説明を自動生成するモデルです(hermes profile describe --auto から呼び出されます)」)に基づいています。対話形式で設定するには、hermes model を実行して「補助モデルの設定」を選ぶと、タスク別の選択画面が表示されます(vision、title_generation、tts_audio_tags、compression、approval、triage_specifier、kanban_decomposer、profile_describer、delegation)。Delegation の項目はトップレベルの delegation.* に保存されます。これは、サブエージェントが「補助的な LLM 呼び出しではなく、完全な子エージェントだから」です。 ↩↩↩↩↩↩↩↩↩↩↩

  35. Hermes Agent v0.21.0 リリースノート、「The Pantheon Release」、タグ v2026.8.31。記載されたリリース日は8月31日、公開日時は 2026-08-31T19:29:49Z です。統計行の原文引用(訳):「v0.20.0 以降: 約5,800コミット · 約2,475件の PR をマージ · 約5,680ファイルを変更 · 約869,000行を追加 · 約135,000行を削除 · 約2,100件の issue をクローズ · 760人以上の貢献者」。位置づけを示す原文引用(訳):「The Pantheon Release。v0.20.0 で Hermes は伝令となり、言葉を発して他のエージェントに伝えるようになりました。v0.21.0 では神々が集結します」および「このリリースには、v0.20.1-v0.20.6 のインフラ向けパッチタグのすべてが含まれています。それらの期間の変更は、ここにすべて記録されています」。上記で使用した機能分野別の原文引用(訳):Bot Mode —「Bot Mode はデスクトップアプリに組み込まれ、デフォルトで有効になりました。すべてのエージェント profile に名前、決定的に生成される顔のアバター(ランダム化と固定の操作付き)、共有一覧内の場所が割り当てられます」および「以前の『マルチエージェント』は内部の接続の仕組みを指していましたが、今では同僚が集まるチャットアプリのように見えます」(#87886、#88243、#89386、#96726)。hermes peer —「返信は各エージェントの正規の Bot Chat に届くため、エージェント間の会話は送信して終わりではなく、永続的に保存され、内容を確認できます」(#88725、#88178、#91487)。cron —「continuity=true は各実行の出力を次の実行に引き継ぎます(そのため、監視処理では報告済みの内容との重複を除外できます)。すべてのジョブに永続的な作業用メモ帳が用意され、監視モードのジョブでは変更がなければ LLM を完全にスキップします」(#91447、#80774、#81139、#81138)。委任 —「実行中の子エージェントを一覧表示し、途中で方針を修正して指示を出したり、早期に停止して部分的な結果を保持したりできます。さらに、子エージェントの出力に対する任意の JSON スキーマ検証、結果に表示される委任ごとのコスト、引き上げられたデフォルト値(250回の反復、同時実行の子エージェント数10)も加わりました」(#85232、#81144、#81142、#86506、#86745)。MCP —「明示的な確認を経て MCP サーバーをインストールする hermes:// ディープリンクです」(#87525-#87581)。CLI —「Ctrl+P であいまい検索対応のコマンドパレットが開き、/model の選択画面では入力に応じて候補が絞り込まれます。/status には推論モード、承認待ちの項目、コンテキスト使用量が表示されます。ステータスバーには、項目ごとの表示切り替えにより、リアルタイムのキャッシュヒット率、レイテンシー、毎秒のトークン数を表示できます」(#90730、#90717、#90745、#98250、#98282、#97666)。ブラウザー —「Hermes が直接、移動、クリック、読み取りを行うようになりました」(#90197、#89366)。プロバイダー —「Meta Model API(Muse Spark)が組み込みプロバイダーとして登場し、CommandCode、Tencent TokenPlan、Nebius Token Factory、Ramp Router、Actual Computer も加わりました」(#88565、#88308、#97917、#97916、#97915、および #79644/#26491 からの取り込み)。セキュリティ —「保護対象のエージェント指示ファイル(AGENTS.md、skills、メモリストア)への書き込みには、常に承認が必要になりました。これにより、プロンプトインジェクションを受けたエージェントが、自身の常設の指示をひそかに書き換えることを防ぎます」(#81152)。これに加えて、機密情報のマスキング処理の全面的な見直し(#80965)、Windows での承認対象の拡大(#84428)、TCC の識別情報(#95091)、Blender MCP の削除(#83404)があります。取り消された変更のセクションの原文引用(訳):「Model Council モード(/council) — 取り込まれた後に取り消されました。このリリースには含まれません」「DCP context engine — 取り込まれた後に取り消されました。このリリースには含まれません」「WS 専用 gateway サーバー(#94245) — マージ後に取り消されました(#96118)。FastAPI は引き続きデスクトップの起動経路に残ります。シーケンス番号付きのイベント再生(#94219)は実際にリリースされました」「Electron は 40.10.2 に戻されました。TCC のインタープリターアンカーは削除されました(リリースされた署名 ID に基づく方式に置き換えられました)」。バグ修正のセクションは次の文で締めくくられています:「……さらに、クローズされた約2,000件の issue に相当する修正があります。この期間は、1日平均約85件の PR がマージされました」。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  36. タグ v2026.8.31 で追加されたプロバイダーです。hermes_cli/models.py に ProviderEntry("tencent-tokenplan", "Tencent TokenPlan", "Tencent TokenPlan (Hy4 preview via api.lkeap.cloud.tencent.com, Anthropic Messages)")(静的エントリー #39)、カタログモデル hy4-preview、hy3、hy3-preview、表示専用の選択グループ "tencent": ("Tencent Hy", "Hy4 / Hy3 via TokenHub & TokenPlan", ["tencent-tokenhub", "tencent-tokenplan"]) が追加されています。plugins/model-providers/ には nebius-token-factory/ と router/ が追加され、どちらも auth_type="api_key" を宣言しているため、自動拡張の仕組みに取り込まれます。router プラグインの docstring からの引用です。「Ramp の LLM gateway である Ramp Router 用のプロバイダー profile です。OpenAI Responses 互換の単一エンドポイント https://api.router.com/v1 が、各リクエストを上流プロバイダー(OpenAI、Anthropic、xAI、Fireworks など)に振り分け、サーバー側でフォールバックと支出管理を処理します」…「Responses API がネイティブの通信方式です。」…「有効なモデル ID は、そのキーの GET /v1/models が返すものです(BYOK アカウントでは追加のエントリーが表示されます)。そのため、この profile には fallback_models を含めていません。モデル名をハードコードしないという Router 自身の指針に従い、モデル選択はライブ取得に依存します」。このタグの AI プロバイダーのドキュメントページには、名前付きプロバイダー45件とカスタムエンドポイントの行が表に掲載されています。v2026.8.27 以降に追加された4行を引用します。「Ramp Router | ~/.hermes/.env 内の RAMP_ROUTER_API_KEY(プロバイダー:router、エイリアス:ramp-router、ramp、router.com。Responses ネイティブの gateway、アカウント単位のライブカタログ)」、「Nebius Token Factory | ~/.hermes/.env 内の NEBIUS_API_KEY(プロバイダー:nebius-token-factory、エイリアス:nebius、nebius-tf、tokenfactory)」、「Tencent TokenPlan | ~/.hermes/.env 内の TOKENPLAN_API_KEY(プロバイダー:tencent-tokenplan、エイリアス:tokenplan、tencent-lkeap。Anthropic Messages エンドポイント)」、「Alibaba Cloud (Token Plan) | ~/.hermes/.env 内の ALIBABA_TOKEN_PLAN_API_KEY(プロバイダー:alibaba-token-plan、中国本土のエンドポイント:alibaba-token-plan-cn)- Model Studio の定額トークンプラン」。model_overrides は、このタグの hermes_cli/config_defaults.py にあります("model_overrides": {}。明示的な model_overrides.<provider>.<model_id> エントリーはカタログより優先され、_default エントリーはカタログに含まれないモデルに限って不足分を補います)。 ↩↩↩↩↩↩↩↩

  37. タグ v2026.8.31 における cron の継続性です。cron のドキュメントページ(このタグでのソースは website/docs/user-guide/features/cron.md)からの引用です。「continuity=true を設定すると、ジョブは自身の直近の出力を毎回の実行に注入します。通常、定期ジョブは前回の記憶がない状態で実行を開始するため、ニュース収集では同じ記事を再び報告し、監視では同じ条件で再び通知してしまいます。継続性を有効にすると、ジョブは前回の報告内容を参照した状態で起動し、重複を除いて前回の続きから処理できます」、「2回目以降の実行では、前回の出力が継続性を促す指示(『すでに報告した内容を繰り返さない』)とともに先頭に追加されます…内部では、このフラグは context_from 内の予約済みエントリー self として保存されます」、「CLI からは hermes cron create "every 6h" "Scan for news" --continuity を使用します。既存のジョブでは hermes cron edit <job_id> --continuity / --no-continuity で切り替えられます。同じ切り替えは、ダッシュボードの cron エディターとデスクトップの Bot Mode ルーティンダイアログにもあります」。ジョブごとの推論量についての引用です。「ジョブはモデルの固定とは独立して、独自の思考レベルを固定できます。指定できるのは none、minimal、low、medium、high、xhigh、max、ultra のいずれかです。設定すると、そのジョブの実行ではグローバルの agent.reasoning_effort とモデルごとの agent.reasoning_overrides の両方より優先されます」。設定には hermes cron create/edit --reasoning-effort high を使用します。Bot Chat への配信についての引用です。「bot-chat は、出力を profile の標準の「Bot Chat」セッションに実際のメッセージとして配信します…ここでの受信者はボット自身です。出力を受信メッセージとして受け取り、対応が必要な内容を処理して、チャットで応答します」。メモ帳については、cron/notepad.py モジュールの docstring に「各 cron ジョブが、スケジュールされた起動をまたいで状態(カーソル、ウォーターマーク、監視リスト)を引き継ぐために使える小さな KV メモ帳」とあります。上限は「MAX_VALUE_BYTES(16 KB)」と「MAX_JOB_TOTAL_BYTES(64 KB)」です(「メモ帳は実行のたびにプロンプトに注入されるため、無制限に増えると毎回の起動時のプロンプトが肥大化します」)。また、「書き込みには CLI(hermes cron notepad <job_id> set <key> <value>)を使い、実行中のエージェントがターミナルツール経由で呼び出します。モデル用ツールは追加されません」とあります。監視モードについては、cron/monitor.py の docstring に「監視モードの cron サポート — ハッシュによって不要な実行を抑制する変更検出」とあり、「低コストの監視ソース(monitor_script または monitor_url)」を接続します。「変更なし -> エージェントの実行は完全に抑制されます(LLM なし、配信なし)。そのチェックは通知を伴わない no_change 実行として記録されます」、「出力はバイト単位で厳密に比較されます。タイムスタンプの除去や空白の正規化は行いません。監視スクリプトは安定した出力を返す必要があります…そうしないと、チェックのたびに変更があったと判定されます」、「実現した変更:#80774」と記載されています。 ↩↩↩↩↩↩↩

  38. タグ v2026.8.31 における実行中のサブエージェントの制御です。委任のドキュメントページ(このタグでのソースは website/docs/user-guide/features/delegation.md)の「実行中のサブエージェントへの指示」では、制御用の操作として {"action": "list"}、{"action": "steer", "subagent_id": "sa-0-1a2b3c4d", "message": "focus on pricing instead"}、{"action": "stop", "subagent_id": "sa-0-1a2b3c4d"} が示されています。引用すると、「list は、その会話で稼働中の子エージェントについて、subagent_id、目標、状態、running_seconds、accepting_steer、実行中の会話記録のパスを返します」、「stop は、子エージェントを次の反復の境界で早期終了させます。途中までの結果も、通常の完了メッセージとして会話に戻されます」。制御操作は「呼び出し元自身が生成したエージェントのツリー内に限定されます。別のセッションの子エージェントを参照したり制御したりすることはできません。また、ターンごとのサブエージェント生成上限を消費しないため、上限に達した後も stop は機能します」。指示の配信では、処理順序の競合が正直に示されます(「キューへの登録は配信完了ではありませんが、成功を装うこともありません」。pending_steer は結果に取り込まれ、子エージェントが先に終了した場合は missed_steer が記録されます)。デフォルト値については、hermes_cli/config_defaults.py で delegation.max_iterations: 250(「サブエージェントごとの反復回数の上限です。各サブエージェントには、親の max_iterations とは独立した独自の予算が割り当てられます」)と delegation.max_concurrent_children: 10(「統一された同時実行上限です。バッチごとの子エージェントの最大並列数と、バックグラウンド(background=true)委任単位の最大同時実行数の両方に適用されます…非推奨の max_async_children を置き換えます」)が設定されています。上流には古い記述が1か所残っています。委任のドキュメントページ自体には、まだ「デフォルトで3タスク」とあり、設定リファレンスにも「max_iterations: 50 …(デフォルト:50)」と記載されています。同梱の config_defaults.py とリリースノート(「デフォルト値を引き上げました。反復250回、子エージェントの同時実行数10」)のほうが新しく、互いに一致する情報源です。 ↩↩

  39. タグ v2026.8.31 での一連のセキュリティ強化。指示ファイルの保護:hermes_cli/config_defaults.py では security.protected_instruction_files: True がデフォルトです(コメント:「エージェント指示ファイル(AGENTS.md/CLAUDE.md/SOUL.md/…)への書き込み」)。併せて protected_instruction_extra_patterns: [](ベース名に対する fnmatch)も定義されています。tools/file_tools.py には承認ゲートが実装されており、_PROTECTED_INSTRUCTION_BASENAMES = frozenset({"agents.md", "claude.md", "soul.md", ".cursorrules", ...}) を対象に「保護されたエージェント指示ファイル(必ず承認を求めるゲート)」を適用します。脅威モデルも明記されており、原文では「攻撃経路:AGENTS.md / CLAUDE.md / SOUL.md を編集する、注入された指示」「プロジェクトのコンテキスト指示ファイルは cwd のツリーから読み込まれるため、エージェントが後で実行される可能性のある場所の AGENTS.md は、どれも実際の攻撃対象となる」と説明されています。TCC ID:hermes desktop --setup-tcc-identity は hermes_cli/main.py に実装されています。実装は _desktop_macos_setup_tcc_identity(identity: str = "Hermes Local Signing") で、説明は「hermes desktop --setup-tcc-identity 用の1回限りのセットアップ」です。「(–setup-tcc-identity は macOS 専用のため、スキップします)」「(–setup-tcc-identity には openssl、security、codesign が必要です …)」というチェックもあります。一連の情報マスキング対応(#80965、#80964、#81675、#81686、#88232)、Windows での承認処理の対応範囲拡大(#84428)、Blender MCP の削除(#83404)、Tier-1 のプラグインインストール時スキャン(#80728)は、リリースノートに基づきます。35 ↩↩↩↩

  40. タグ v2026.8.31 での CLI の操作面の変更。hermes_cli/commands.py の COMMAND_REGISTRY には CommandDef("palette", "Open the fuzzy command palette (also Ctrl+P)", "Info", ...) と CommandDef("status", "Show session, model, token, and context info", "Session", ...) が登録されています。つまり、/status は共有レジストリのセッションコマンドであり、メッセージング専用ではありません。_BUILTIN_SUBCOMMANDS に approval-check の項目はありません(全73項目で、v2026.8.27 と同一です)。v0.21.0 のリリースノートで hermes approval-check(#81137)と呼ばれているドライランは、実際には hermes approvals test です。このタグの hermes_cli/subcommands/approvals.py にあるパーサーのヘルプには、「コマンドの承認判定をドライランします(コマンド自体は実行しません)」とあり、--backend(「評価対象のターミナルバックエンド種別(デフォルト:local …)」)と --json が用意されています。hermes_cli/_parser.py の変更は hermes chat 内のみです。-q/--query のヘルプは「実行するクエリです。実際の TTY では、プロンプトを起点に対話型セッションを開始します(最初のターンとしてそのまま送信されます)。–oneshot または -Q と組み合わせた場合、あるいは非 TTY の場合は、回答して終了します。」となりました。新しい --oneshot フラグの説明は「-q/–query-file と併用すると、対話型セッションを開始する代わりに、クエリに回答して終了します(従来の単一クエリの動作)。標準入出力が非 TTY の場合、および -Q/–quiet の指定時には暗黙的に有効になります。」です。また、--max-turns には「会話の1ターンあたりのツール呼び出し反復回数の上限(デフォルト:500、または設定の agent.max_turns)」と記載されています。 ↩↩↩↩↩↩↩↩↩

  41. Hermes Agent v0.21.1 リリースノート。タグは v2026.9.7、記載上のリリース日は9月7日、公開日時は 2026-09-07T22:17Z です。本文は意図的に簡潔にまとめられています。原文では「パッチリリース」とされ、「タグを使ったデプロイと下流の利用者向けに、v0.21.0 以降の現在の main をまとめたもの」と説明されています。対象期間の集計は、準備時点で「変更された4,364ファイルに対し、マージを除く5,139コミット(+601,014 / -768,419)」と「マージ済み PR 632件」です。また、「この期間の変更を整理した完全なリリースノートは、v0.22.0 とともに公開します」とあります。ローカルクローンでの確認では、git rev-list --count --no-merges v2026.8.31..v2026.9.7 = 5,140、git diff --shortstat = +601,018 / -768,423 でした。本文の数値はリリースコミット前のスナップショットで、差分はちょうどそのリリースコミットの分です。それ以前の隣接タグ間で最大だったのは v2026.7.20..v2026.7.30 の、マージを除く2,790コミットでした(v2026.3.12 以降のすべての隣接タグの組み合わせをローカルクローンで計測しました)。トラブルシューティング項目で触れている doctor のチェックは、このタグの hermes_cli/doctor_config.py:330-362(_drift_max_iterations_ghost)にあります。起動時のブリッジ処理が、それ以前の設定解析エラーによって中断されると、.env に残った古い HERMES_MAX_ITERATIONS が agent.max_turns より優先されます(issue #17534)。hermes doctor --fix は、その .env の行を削除します。このセッションでの検証日は2026年9月8日です。 ↩↩↩↩↩

  42. タグ v2026.9.7 の COMPAT_MANIFEST.md(リポジトリルート、3,869行)。原文には「2026年9月の分割(PR #102117)では、Hermes Agent の大きなモジュールを、役割を絞ったファイルに分割しました」「内部インポートパスは安定した API ではありません」「この層は一時的なもので、2026年9月14日に削除されます。 1つのコミットで追加されており、そのコミットを revert することで削除されます」とあります。挙動の表では、2026年9月14日より前は、プラグイン名、日付、hermes plugins compat を示す黄色の通知が表示され、プラグインは「読み込まれます。古いパスを解決するたびに、HermesPluginCompatWarning が1回出力されます」とされています。2026年9月14日以降は「赤色の通知:プラグインは無効」となり、「読み込まれません。hermes plugins list に理由が表示されます」。Desktop では「初回のみモーダルを表示します」。回避策については、原文に「config.yaml で plugins.allow_deprecated_imports: true を設定すると、期限後も、revert によってパスが実際に削除されるまでは、影響を受けるプラグインを引き続き読み込めます」とあります。種別ごとの件数は、moved-lazy 1148、import 592、restored-def 290、restored-helper 41、restored-import 17、module-stub 3、unrestorable 34 です。対象範囲は公開されているトップレベルの名前のみで、「テストで monkeypatch を差し込む箇所も同様に維持されません」とされています。チェッカーのパーサーは hermes_cli/subcommands/plugins.py:104-112 にあり、コマンドは hermes plugins compat [path] [--json] です。原文の説明は「有効なすべての外部プラグインを静的にスキャンして、分割前のモジュールパスのインポート(COMPAT_MANIFEST.md を参照)を調べ、ファイル:行、旧パス -> 新パスを出力します。影響を受けるプラグインが1つでもあれば、終了コード1で終了します」です。このタグで分割後の構成を確認しました。agent/ はトップレベルモジュール214個とサブパッケージ7個(lsp、monitoring、pet、proxy_sources、secret_sources、transports、verify)、hermes_cli/subcommands/ は61モジュールです。hermes_cli/models_catalog_static.py:311 の CANONICAL_PROVIDERS は39項目で、スラッグは v2026.8.31 の hermes_cli/models.py にある一覧と同一です(xai の静的タプルを含み、plugins/model-providers/ も引き続き39ディレクトリです)。以前のトップレベルの prompt_builder.py はなくなり、現在は agent/prompt_builder.py にあります。AIAgent は引き続きルートの run_agent.py に置かれています。その後の状況は、ガイド v1.19 向けに再検証しました(2026年9月15日)。削除は予定どおり有効になりましたが、revert ではなく日付によるゲートで制御されていました。タグ v2026.9.14 では、hermes_cli/plugin_compat.py:32 に COMPAT_REMOVAL_DATE = _dt.date(2026, 9, 14) が設定されています。removal_in_effect()(86〜90行目)は、その日付以降、またはマニフェストファイルが存在しない場合に true を返します。allow_deprecated_imports()(261〜268行目)はリテラルの真偽値のみを受け付けます(ガードは ... is True で、ソース内のコメントは「リテラルの真偽値のみ」です。そのため、"false" や "no" のような YAML 文字列で、削除後の制限回避が有効になることはありません)。古いパスを削除する revert は、まだ取り込まれていません。COMPAT_MANIFEST.md、compat_manifest.json、hermes_cli/plugin_compat.py は、v2026.9.14 と main のコミット 5d59366010(2026年9月15日12:55 PT、同日に取得)の両方に存在しています。そのため、この回避策では引き続き古いパスを解決できますが、revert が取り込まれた時点で機能しなくなります。ガイド v1.20 向けにも再検証しました(2026年9月22日)。依然として revert は行われておらず、3つのファイルはすべてタグ v2026.9.21 と main のコミット a53b42ddea(2026年9月22日にコミット、同日に取得)に存在しています。v2026.9.21 でも、ゲートとガードに実質的な変更はありません。COMPAT_REMOVAL_DATE は引き続き plugin_compat.py:32、removal_in_effect() は :86 にあります。allow_deprecated_imports() は現在 :296-303 にありますが、リテラルの真偽値を確認するガードは同じです(... is True。コメントは現在「リテラルの真偽値のみ:YAML の "false" / "no" によって削除後の制限回避を有効にしてはいけません」となっています)。v0.21.4 の対象期間における、このモジュールの変更はパフォーマンスと移植性に関するものだけです。各プラグインディレクトリの (relpath, mtime_ns, size) というファイルシグネチャをキーにした、プロセス全体で共有するスキャンキャッシュが追加されました(多重化された gateway では、提供する profile ごとにプラグインを検出するため、起動処理で全プラグインのソースを毎回解析し直すと、profile ごとに約0.4秒かかっていました)。また、ネイティブ Windows での検出結果のパスが POSIX 形式になりました(#112576)。マニフェスト自体からは opencode 関連の2行(_OPENCODE_KEYLESS_EXTRA_SLUGS、is_opencode_zen_free_model)が削除されましたが、構造上の変更はありません。 ↩↩↩↩↩↩↩↩↩

  43. タグ v2026.9.7 の docs/session-lifecycle.md、セクション「6. 明示的な会話の区切り」より、原文全文の訳:「操作がない状態や実時間の経過によって会話が切り替わることはありません。/new と /reset は明示的な区切りを作成し、長い履歴は引き続きコンテキスト圧縮で管理します。従来のタイマー設定は無視されます。既存の SessionResetPolicy データ型は互換性のために残された非稼働のデータであり、実行時のポリシーではありません。明示的に一時停止した場合は、引き続き次の受信ターンで区切りが作成されます。復旧時は、明示的な区切りと過去に確定した区切りを維持し、それらを再び開くことはありません。リソースのみの解放や WebSocket の孤立プロセスの回収を行っても、会話は再開可能な状態に保たれます。」 ↩↩↩↩

  44. タグ v2026.9.7 における MCP の認可です。パーサー:hermes_cli/subcommands/mcp.py:55-66 – login(「OAuth ベースの MCP サーバーで再認証を強制します」)は --flow を受け取り、選択肢は browser/device です。ヘルプ原文の訳:「OAuth フロー(oauth.flow を上書き):ブラウザーの PKCE または RFC 8628 のデバイスコード」。reauth(「1つの OAuth MCP サーバー、またはすべてのサーバー(–all)を再認証します」)は任意の名前と --all を受け取ります。デバイスコードフローは対象期間内に導入されました。コミット f5afe8bd40「feat: CLI からデバイスコードで MCP サーバーを認可」です。関連する堅牢化について、対象期間内のコミット件名は次のとおりです。f914c9b070「fix(mcp): OAuth セッション全体で profile の所有権を厳格に適用」、f94307a7f7「fix: 不正な形式の MCP OAuth メタデータキャッシュを無視」、e3ba651b6d「fix(desktop): クライアント側のローカルコールバックを通じて MCP OAuth を中継」。toolset で絞り込む起動処理:tools/mcp_tool_discovery.py:412-426 – このフィルターは、「hermes -z -t <toolsets>」で「呼び出し元が必要としないサーバーのコールドスタートを省略」できるように設けられており、フィルターが空の場合は MCP の読み込み全体を省略します。 ↩↩↩

  45. タグ v2026.9.7 における委任処理の信頼性です。委任ツールのソースから確認しています。完了単位:tools/delegate_tool_dispatch.py:326-341(_units_of)– 原文の訳:「デフォルトでは無効です(delegation.independent_completions)。呼び出し全体を1つの単位とし、1つのメッセージとして返します。タスクごとに完了通知が相次ぐと(各通知で新しいターンが発生)、それを想定していないオーケストレーターの処理が分断されていました。」単位は、異なるタスク group ごとに1つ(初出順)と、グループに属さないタスクごとに1つで、それぞれが個別に会話へ戻ります。対象期間内のコミットは c89f3b8800「fix(delegation): デフォルトでは呼び出しごとに1回の完了通知に変更し、キュー内の単位が停滞しないよう修正」です。バックグラウンドプロセスの引き継ぎ:コミット 3c0d90e8ef「feat(delegation): サブエージェントがバックグラウンドプロセスを親に引き継ぎ、残ったプロセスは信頼せず明示的に列挙」。このタグでは、tools/delegate_tool_child_run.py:744-763(account_background_processes)が引き継いだプロセスを結果に記録します。また、引き継がれずに稼働を続けているプロセスを orphaned_processes、終了したものの結果が一度も読み取られていないプロセスを unread_completions(出力の末尾を含む)として列挙してから、cleanup がそれらを終了します。docstring では、親は子の「監視プロセスが稼働中」という主張を信用するのではなく、「ランタイムからその情報を受け取る必要がある」としています。引き継ぎ操作は process_manage(action="handoff")(子のみ)で、レジストリのロック下で process_registry.transfer_ownership を通じて ProcessSession.owner_task_id を切り替えます(同タグの tools/AGENTS.md、委任セクション)。フォールバックの設定:hermes_cli/config_defaults.py の delegation.fallback_providers。コメント原文の訳:「固定されていない子では、null は親のチェーンを継承し、[] はフォールバックを無効にします。プロバイダー、エンドポイント、モデルのいずれかで固定された子には、この設定で明示的に指定しない限りフォールバックはありません。」チェーンの検証は tools/delegate_tool_config.py:417-425(_resolve_child_fallback_chain)で行われます。「不正な形式のエントリーは、標準の正規化処理で除外されます。」クラッシュ時の永続性:tools/async_delegation.py:222-246 は、複数の子を含む単位がまだ実行中の場合、完了した子をその単位自身の行に永続的に記録します("partial": True)。そのため、単位全体の完了前にクラッシュしても、完了済みの子の結果は保持されます。キャッシュ階層:tools/delegate_tool.py:106-112(_apply_child_cache_ttl)、原文の訳:「委任された子が1時間のキャッシュ階層を使用することはありません。」_cache_ttl == "1h" の子は "5m" に設定されます。 ↩↩

  46. タグ v2026.9.7 におけるプロバイダーとモデルです。Astra の階層:hermes_cli/models_catalog_static.py:22-25 – openai/gpt-6-astra-fast は「料金2倍、優先階層」、-flex は「料金0.5倍、flex 階層」で、さらに -pro-fast/-pro-flex があります。gpt-6-astra と -pro は OPENROUTER_MODELS に含まれ、除外集合 _OPENROUTER_ONLY には含まれないため、Nous Portal でも扱われます。Astra の利用制限と900K:hermes_cli/codex_models.py:96-101(「Astra はアカウント単位で利用が制限されているため、現在のアカウントに対応する最新のカタログのみが掲載できます」)および agent/model_metadata.py:1447-1462 – Codex OAuth が提示する値は272Kです。gpt-6-astra は900Kの対象で、コメントには「提示値は272K、920,043の入力は成功、1,000,043は拒否(2026年9月4日の実環境)」とあります。CODEX_CONTEXT_VARIANT_SUFFIX = "-900k" は「選択画面でのみ使うオプトイン用の接尾辞で、通信では送信しません」(OpenRouter 側の Astra のコンテキストは、model_metadata.py:334 によると1,050,000です)。同じ静的ファイルの新しいカタログ項目(30〜42行目):anthropic/claude-fable-5.1、google/gemini-3.8-flash と gemini-3.7-flash、qwen/qwen3.8-max-0902 と qwen/qwen3.8-flash、meta/muse-spark-1.3 と -contributor(agent/model_metadata.py:349 によるとコンテキストは1Mです)。muse-image:plugins/image_gen/meta-ai/__init__.py(「Meta Model API(muse-image):OpenAI 互換(https://api.meta.ai/v1)」、モデルには muse-image-1.0 などが含まれます)。Tavily:hermes_cli/config_defaults.py:2522-2525、原文の訳:「AI ネイティブなウェブ検索と抽出に使用する Tavily API キー(任意 – Tavily 選択時はキーなしで動作します)」。ツールは web_search と web_extract です。web ブロックには、Tavily は「hermes tools からオプトインするキー不要の機能で、リングのメンバーではありません」と記されています。管理対象の llama.cpp ランタイム:hermes_cli/local_runtime/ パッケージ(「管理対象の llama.cpp ランタイム」)、config_defaults.py:2327 の設定ブロック(「公式バイナリと、監視下の1台のサーバー」。ドキュメントの参照先は user-guide/local-models)、およびデスクトップ側の apps/desktop/src/api/local-models.ts です。外部プロセス型プロバイダー:agent/auxiliary_client.py:4740-4799(_resolve_external_process_branch、「PROVIDER_REGISTRY の external_process プロバイダーを、登録済みの profile を通じて提供」。登録済みの profile をキーにすることで、「ツリー外の ACP プロバイダー」も解決できます)。カタログの更新間隔:hermes_cli/config_migrations.py:622-627 の設定移行39 -> 40(「model_catalog.ttl_hours -> ttl_minutes(デフォルト20)」、ユーザー向けメッセージは「モデルカタログは20分ごとに更新されるようになりました(model_catalog.ttl_minutes)」)。hermes_cli/model_catalog.py は、従来の ttl_hours を「ttl_minutes がまだデフォルト値の場合に限り」適用します。 ↩↩↩

  47. タグ v2026.9.7 でのデスクトップ関連の一連の更新。コメントモード:同タグの website/docs/user-guide/desktop.md に記載された説明の要点(原文引用の訳):「プレビューブラウザーのバーで Annotate をクリックし、表示中のページ上の要素をクリック(またはドラッグして範囲を選択)してメモを入力します。保存したコメントは、それぞれ番号付きのピンとしてページ上に残ります」「ピンを保存してもターンは送信されません」「Add N comments を押すと、ピンごとに切り抜いたスクリーンショットと、各コメントを示す短いプロンプトが入力欄に添付されます」「各要素へのコメントには、その要素の CSS セレクター、マークアップ、レイアウトに関係する計算済みスタイルが含まれます。そのため、エージェントは画像から推測するのではなく、ソース内の要素を特定できます」「パスワードや非表示フィールドの値、キーやトークンと思われる属性は、マークアップがページの外に送信される前にページ上で伏せられます」「コメントが多い場合は、ページのどの部分にあるかでグループ化して渡されます。20件ほどのコメントも、1件ずつ個別のタスクにするのではなく、少数の作業単位にまとめられます」「各グループは別々の DOM サブツリーなので、通常は変更対象のファイルも分かれます。これにより、並列ワーカーへ安全に割り当てられます」。対象期間内のコミット:10f2a20966「feat(desktop): アプリ内ブラウザーにコメントモードを追加」、e4bda3ff77「feat(desktop): ブラウザーのコメントに要素のセレクター、マークアップ、スタイルを付加」、セッション操作関連の 8cb2bcc8c1「構造化されたセッション操作を公開」+ bfddf556bf「構造化されたセッション操作に状態を復元」+ dffd8d62c2「セッション自動化の操作を追加」、6b1e12c7f4「New session、プロジェクトと操作項目、profile グループからのドラッグでセッションを作成」、9186e3ebc5「他のコーディングエージェントの会話記録を取り込むセッションインポート画面」、a1c25d393a「Capabilities → Skills に、ワンクリックでインストールできる任意の skill カタログを内蔵」、ロシア語ロケールの a922dad9d8「feat(desktop): ロシア語(ru)ロケールを追加」+ 269e5bde33(ロケールのテストとドキュメントに ru を登録。apps/desktop/src/i18n/ru.ts はこの期間に追加されましたが、CLI の locales/ は引き続き17個のカタログです)。display.resume_last_session:hermes_cli/config_defaults.py:777、既定値は True、コメントの原文引用の訳は「デスクトップアプリはコールドスタート時に最後のチャット/ページを再度開きます(Settings → Appearance からも設定できます)」。実際の profile の利用同意:apps/desktop/src/app/chat/right-rail/real-profile-consent-dialog.tsx(「実際の profile を使ったブラウジングを初めて開く際の同意プロンプト」。browser.use_real_profile がオフの状態で Browser ペインを開くと表示されます。同意すると Capabilities の切り替えと同じ設定キーに書き込みます。「今はしない」ではアプリの実行中は表示を抑制し、「今後表示しない」では次回以降の起動でも非表示が維持されます)。 ↩↩

  48. Hermes Agent v0.21.2 リリースノート、「state.db のパッチリリース」、タグ v2026.9.11、記載されたリリース日は9月11日、公開日時は2026-09-11T19:20Zです。位置づけの原文引用の訳:「v0.21.0 ではセッションストアの接続処理を大幅に書き直しましたが、一部の環境では state.db が不安定になりました。複数の書き込み処理が互いのロックを解除する、正常なデータベースが破損していると報告される、1件の不正な行で sessions list が失敗する、といった問題です」。コミット 04dd80a977 時点の集計:「マージを除く947コミット」「1,869ファイルを変更」「312件の PR をマージ」「140人の貢献者」(ローカルクローンでの確認:git rev-list --count --no-merges v2026.9.7..v2026.9.11 = 959。本文の数値はリリース前のスナップショットで、v0.21.1 と同じ傾向です)。取り組みの見出しの原文引用の訳:「state.db の信頼性向上キャンペーン(6件の PR、44件の issue をクローズ)」(PR #108076、#108082、#108130、#108086、#108074、#108067)。更新手順の原文引用の訳:「まず hermes doctor を実行してください。構造の破損とインデックスの破損を正しく区別するようになり、再構築だけでは不十分な場合は、profile を固定した hermes sessions recover --inspect-only を案内します」。同タグのソース確認:gateway/hosted_rooms.py:398-426 でホスト型ルームの状態をルートストアから分離しています。default_db_path は profile の gateway の保存先を「マスターの state.db ではなく、共有 ROOT の shared-state.db」に解決します。そのドキュメント文字列では、6つの gateway を運用する環境で繰り返し確認された複数の書き込み処理による破損経路(2026-09-03)を、profile の gateway がマスターセッションストアを書き込み可能な状態で開いてはいけない理由として挙げています。hermes sessions recover のパーサーは hermes_cli/subcommands/sessions.py:185-196 にあり、--inspect-only のヘルプの原文引用の訳は「正規テーブルが読み取り可能かどうかのみを報告し、出力データベースは作成しません」です。このサブコマンドは対象期間より前から存在していました(v2026.8.31 の hermes_cli/main.py に存在します)が、このガイドでは未掲載でした。認証情報保管庫:agent/vault_backends/__init__.py のドキュメント文字列(「ブラウザーの認証情報保管庫用ログインバックエンド」。ハンドルをバックエンドごとの名前空間に分け、ブラウザーツールがスキーマを変更せずに処理を振り分けられるようにします。外部マネージャーはセッションごとにロックを解除するまで利用できません。マスターパスワードは「ツールの引数にも argv にも渡されず、永続化もされません」)、agent/vault_backends/base.py(LoginBackend は「ログインのメタデータのみを一覧表示し、秘密情報は表示しません。入力時に1つのパスワードを取得します」)、agent/vault_store.py:74-105(認証アプリ用のキーは base32 シードまたは otpauth://totp URI のみを受け付け、カウンターベースの HOTP は拒否します。コードは totp_now で生成します)。バックエンドの local.py、onepassword.py、bitwarden.py と、agent/secret_sources/{onepassword,bitwarden,command}.py は、いずれも同タグに存在します。プラグインカタログのサブパーサーは hermes_cli/subcommands/plugins.py にあり、ヘルプは install が「厳選カタログ、Git URL、または owner/repo からプラグインをインストール」、search が「厳選された Hermes プラグインカタログを検索」、browse が「厳選プラグインカタログの全項目を一覧表示」、pack が「宣言的で共有可能なプラグインセット(hermes-pack.yaml)」で、install/export/show を備えています。ゲスト向け初期設定は apps/desktop/electron/guest-onboarding-flag.test.ts にあり、テスト名の原文引用の訳は「guestOnboardingEnabled: 環境変数が正確に “1” の場合、または argv に –guest-onboarding がある場合に無料枠を有効にする」です。このテスト群では、'true'、'0'、空の値はいずれも無効になることと、desktopBackendSpawnEnv が「起動時の判断を最後に設定し、継承した値が入り込むことを防ぐ」ことを検証しています。複数の profile の堅牢性を高める issue 群 #107609-#107630 は、リリースノートに記載されています。このセッションでの確認日は2026年9月15日です。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  49. Hermes Agent v0.21.3 リリースノート、タグ v2026.9.14、記載されたリリース日は9月14日、公開日時は2026-09-14T16:04Zです。目的の原文引用の訳:このタグは「以下のリモート gateway のサインイン修正を、最新のリリースタグに自動更新される Cloud エージェントへ届けるために存在します」。コミット 9b419a2d3c 時点の集計:「マージを除く1,036コミット」「2,642ファイルを変更」「338件の PR をマージ」(ローカルクローンでの確認:git rev-list --count --no-merges v2026.9.11..v2026.9.14 = 1,037。今回も差分はリリースコミットです)。記載された2項目はいずれもローカルクローンで確認済みで、この期間にのみ存在します。コミット 5dea46d13d「fix(dashboard-auth): Cookie ゲートとネイティブルートで更新処理を1つに集約し、イベントループの外で実行」(#110061、#55712 を修正。Portal 側の hermes-portal#1209 と組み合わせ、操作のたびに延長される30日間のアイドル期限と、トークン更新時の5分間の猶予期間を設けます)と、コミット 939a2f64b4「fix: 長時間稼働するプロセスによる state.db の書き込みハンドルの重複生成を停止」(#110934、#100896 と #103339 を修正)です。掲載延期についての原文引用の訳:「この期間の変更を整理した完全なリリースノートは v0.22.0 に同梱し、v0.21.0 以降のすべてを記載します」「この期間の変更を省略することはありません」。意図的に詳細を未掲載とした項目には、サーバーからクライアントへの JSON-RPC リクエストと Pydantic の通信契約レジストリ、すべてのモデル選択画面での推論量の選択、OpenRouter OAuth PKCE、HEIF/HEIC/AVIF のデコード、Honcho のピアモデルの再設計、FAL カタログへの追加(Wan 3.0、Kling 3.0 / Kling Image v3、MiniMax H3 Max Turbo、Gemini Omni Flash 1.1、Meta Muse)、Slack に貼り付けた表と Agent Sessions API、多重化された profile の分離と gateway の生存確認に関する修正、VM をまたぐファイルシステムでの state.db WAL の使用拒否が含まれます。リリースノート自体の方針に従い、これらはすべて v0.22.0 の調査まで保留しています。このセッションでの確認日は2026年9月15日です。 ↩↩↩

  50. Hermes Agent v0.21.4 リリースノート、タグ v2026.9.21、記載上のリリース日は9月21日、公開日時は2026-09-21T18:10:55Zです。目的については「パッチリリースです。このタグは、v0.21.3以降にマージされた約1,800件のPRを、下流の利用先(Dockerイメージ、Hermes Cloud、ホスティング環境へのデプロイ)向けの安定したタグ付きリリースにまとめたものです。この期間の詳細を整理したノートはv0.22.0に持ち越します」と明記されています。コミット 4b8a8134009a 時点の統計は、「マージ以外のコミット5,071件」、「変更ファイル5,169件」(+312,961 / -62,855)、「マージされたPR 1,812件」、「クローズされたIssue 2,116件」です。ローカルクローンでの確認でも、5つの数値すべてが完全に一致しています(git rev-list --count --no-merges v2026.9.14..4b8a8134 = 5,071、git diff --shortstat = 5,169ファイル、+312,961 / -62,855。タグのコミット d337b736aa「chore(release): v0.21.4 (v2026.9.21)」は 4b8a8134 の子コミットなので、マージ以外は5,072件、マージを含む合計は5,173件となり、v2026.9.14...v2026.9.21 に対するGitHubの比較APIも total_commits: 5173, ahead_by: 5173, behind_by: 0 を返します)。期間別の順位(ガイドv1.21向けに9月23日に再確認)は、隣接するすべての v2026.* タグ間のマージ以外のコミット数で見ると、v2026.8.31..v2026.9.7(リリースコミットを含め5,140件)が最多で、v2026.9.14..v2026.9.21(5,072件)が2位、v2026.7.20..v2026.7.30(2,790件)がそれに続きます。リリースに記載されたマージ済みPR数では、1,812件は単一期間の集約ノートとして最多です(v0.21.1は「マージされたPR 632件」、v0.19.1は「約1,000件以上のPR」です。v0.21.0の「約2,475件」はv0.20.0以降の6つのv0.20.xタグにまたがるため、単一のタグ間の期間ではありません)。詳細の持ち越しについては、「この期間の詳細を整理したリリースノートはv0.22.0に同梱し、v0.21.0以降のすべてを記録します」「この期間の内容は何も省略しません」と明記されています。意図的に詳細の記載を見送った項目として、gatewayのシングルトンロックとランデブーレコード、および稼働中のホストバックエンドへのDesktopの接続、バックエンドが管理するコネクター操作とDesktop/TUI/CLIの設定カード、--format stream-json、skills.auto_load、Desktopのチャット/UIフォント選択とワンクリックでのローカルエンジン更新とPluginsハブからのアンインストール、未認可DMに対する decline の動作、mcp.discovery_concurrency、session_search のafter/beforeによる期間指定とOR条件に緩和した再検索、hermes sessions set-journal-mode、動画カタログのLTX 2.5とKling O3、固定コミットのREADMEと追加日・更新日による並べ替えを備えたプラグイン別・作者別のカタログサイトページ、「カタログに追加された十数個のコミュニティプラグイン(tailscale、ssh、shodan、terminal、rss、resetwatch、done-bell、kiwi、cognee、Octen)」(リリース内の略称です。タグ時点のカタログ項目は hermes-tailscale、hermes-ssh、shodan、hermes-terminal、hermes-rss、hermes-resetwatch、done-bell、kiwi、cognee、web-octen です)、そして「profile/multiplexの分離、cron、カンバン、Desktop、state.dbに関する多数の修正」が挙げられています。更新には hermes update(gitでインストールした場合)またはインストーラーの1行コマンドを使います。「Docker / Hermes Cloud:イメージはこのタグ(nousresearch/hermes-agent:v2026.9.21)からビルドされます」。本セッションでの検証日は2026年9月22日です。 ↩↩↩↩↩↩

  51. v0.21.4で公開された項目は、タグv2026.9.21のソースで検証しています(ガイドv1.20、2026年9月22日。運用者向けルールはガイドv1.21、9月23日に追加)。ホスト単位のシングルトン:gateway/host_rendezvous.pyのdocstringには、「ホスト全体のシングルトン用ランデブー:OSユーザーごとに、ROLEごとに1つのロックと1つのレコード」「ホストごとにhermes serveとhermes gateway runをそれぞれ厳密に1つだけ実行し、それぞれがすべてのprofileを多重化する」とあります。ホストのflock/msvcrtロックを「取得に成功したプロセスの存続中ずっと保持」し、ランデブーレコードと併用することで、2回目の起動時に「同じ稼働中のプロセスであることを証明し、2つ目のポートをバインドせずにATTACHする」仕組みです。(pid, createTime)によって「古くなったことは推測せず、必ず証明する」としています(「接続するクライアントは、再利用されたPIDのポートに決して接続してはならない」)。ロックのルートは$HERMES_GATEWAY_LOCK_DIR、未設定なら$XDG_STATE_HOME/hermes/gateway-locksで、OSユーザー単位のスコープです(gateway/status.py:308-324:相対パスのXDG_STATE_HOMEは無視し、~/.local/stateにフォールバックします)。運用時の処理経路:gateway/run.py:5466-5499の_host_attach_or_noneは、ATTACHでは接続メッセージを表示して終了コード0で終了し、REFUSEでは拒否します。REPLACE_HOSTでは「どのhomeから起動されたかにかかわらず、HOSTプロセス」に--replaceを送り、--force指定時は確認を省略します(「所有プロセスが応答不能、または虚偽の状態を返す場合の運用者向け脱出手段」)。_claim_host_gateway_role(gateway/run.py:5331-5346)では、ロック取得競争に負けたプロセスをEX_TEMPFAIL(75)で終了させます。理由は「生成するすべてのスーパーバイザーは75で再試行し、その時点では所有プロセスのレコードが存在する」ためです。gateway/host_attach.pyには5つの結果があります。ATTACH、RESCAN->ATTACH(制御ソケットのrescan-profiles)、REPLACE_HOST、REFUSE(「2つ目を無断で起動しない」)、STARTです(profileごとの独立したgatewayは「移行が強制されるまで共存する(#109417)」)。Desktop側:apps/desktop/electron/host-backend-attach.ts(「ホスト上で稼働中のHermesバックエンドに接続する(多重化専用、Desktop側)」)。I/Oの段階的な処理では、マシンルートの起動台帳を読み、「HTTP準備完了確認 -> 配信されたセッショントークン -> WebSocket認証」の順で候補を検証します。また、「2つのアプリが同時に起動しても、バックエンドが2つではなく1つになるよう、ホストレベルのゲート」を保持します。HOST_SPAWN_GATE_STALE_MS = 60_000です。コネクターの操作:tools/connectors/operation.py:1には「manage_connections呼び出しごとに、バックエンドが所有する接続操作を1つ実行する。純粋なデータのみで、I/Oは行わない」と記載されています。OPERATION_DEADLINE_SECONDS = 300.0には「設定キーではない。ユーザーが調整できる待機時間は、上下限を設けても誤用を招いた(PR1では実装したが、未マージ)」というコメントがあります。ツールはmanage_connectionsとして登録されています(tools/connectors/tool.py:16,48,113)。接続先ごとのrequired_envは「({name, prompt, required})。カードは各項目に入力欄を表示し、必須項目すべてにテキストが入るまで操作を保留する」とされています。3つのフロントエンドで使うカードについては、tests/hermes_cli/test_mcp_catalog_env_boundary.py:330に記載があります(「コネクターカードのバックエンド(Desktop/TUI/CLIのセットアップカード)でも、同じようにシークレットのみを分離する」)。stream-json:hermes_cli/_parser.py:247-249のchatパーサーでは、--formatの選択肢はtext/stream-json、デフォルトはtextです。ヘルプには「’stream-json’は改行区切りのJSONイベント(JSONL)を出力し、–quietを暗黙的に有効にします。–tuiとは併用できません」とあります。hermes_cli/stream_json.pyのモジュールdocstringには「stdoutの各行にJSONオブジェクトを1つ出力する……system/init -> text差分 / tool_use / tool_result -> 最後に1つのresultエンベロープ(終了コード、最終テキスト、トークン統計)。診断情報とsession_idはstderrに出力する」とあります。_TOOL_OUTPUT_CAP = 5000で、禁止された組み合わせでは終了コード2で終了します。hermes_cli/stream_json.py:23のstream_json_requestedは、queryまたはquery_fileのいずれかを受け付け、どちらもない場合は終了コード2で終了します(cli.py:1703-1705のFireエントリーポイントでは、解決済みのクエリを確認します)。hermes_cli/_parser.py:218-222の--query-file PATHは、-qと相互排他的なグループにあります(ヘルプ:「コマンドラインの代わりに、ファイルから1つのクエリを読み込みます(’-‘はstdinを読み込みます)。任意のテキストを安全に扱えます。シェルによる解釈は一切行いません」)。_read_query_file(hermes_cli/main.py:1735-1762)で読み込み、タグv2026.8.19から存在します。契約テストはtests/hermes_cli/test_stream_json.pyにあります(「stream-jsonでは決してstdoutに出力されてはならない」という検証も含みます)。skills.auto_load:hermes_cli/config_defaults.py:1435、デフォルトは[]です。コメントには「新しいセッションごとに完全に読み込むよう固定するskill名(CLI、TUI、gateway、cron、API)。エージェントのプロンプトを初めて構築するときに1回だけ解決する。存在しない名前や無効な名前は警告してスキップする。HERMES_IGNORE_RULESは、ほかの自動挿入コンテキストと同様にこのリストを抑制する」とあります。decline:gateway/config.py:137-139のコメントには「’pair’はペアリングコードをDMで送り、’ignore’は無応答で破棄し、’decline’は丁寧な拒否メッセージを1回送った後、gateway.pairing.DECLINE_DEDUPE_SECONDSの間、その送信者には応答しない(#88028)」とあります。UNAUTHORIZED_DM_BEHAVIORS = {"pair", "ignore", "decline"}で、フィールドのデフォルトは"pair"(:626)、unauthorized_dm_decline_messageが空の場合はDEFAULT_UNAUTHORIZED_DM_DECLINE_MESSAGEを使います(ペアリングの節で引用した返信文)。gateway/pairing.py:37,565-576にはDECLINE_DEDUPE_SECONDS = 24 * 3600と、エイリアスを考慮した拒否時刻の記録処理があります。プラットフォームごとの解決とEmailのデフォルトはget_unauthorized_dm_behaviorにあります(gateway/config.py:803-809:「Emailは受信トレイ型なので、固有のunauthorized_dm_behaviorで有効にしない限り、デフォルトは"ignore"となる(グローバルのデフォルトでは有効にならない)」)。キー自体とpair/ignore、Emailのルールは対象期間より前から存在します(v2026.9.14のgateway/config.py:564,736-742に存在。2026年3月に#1919で導入)。新しいのはdeclineだけです。実効デフォルト:gateway/authz_mixin.py:699-740の_get_unauthorized_dm_behaviorでは、docstringに記載された順序は「明示的なプラットフォーム別設定、Email -> “ignore”、明示的な非デフォルトのグローバル設定、アダプターのdm_policy(pairing -> “pair”、allowlist/disabled -> “ignore”)、何らかの許可リストが設定されていれば -> “ignore”……、それ以外は”pair”」です(#9337)。グローバル設定を参照するのは!= "pair"の場合だけです。YAMLの構造:platforms.<name>配下のプラットフォーム別キーはPlatformConfig.extraへ取り込まれます(gateway/config.py:456-460、#10206)。トップレベルのキー、または入れ子になったgateway.unauthorized_dm_behaviorはgateway/config_loader.py:39-46,102で橋渡しされます。hermes gateway setupはwrite_platform_config_fieldを介してplatforms.<name>.unauthorized_dm_behaviorを書き込みます(hermes_cli/config.py:2061-2069、hermes_cli/gateway_setup_wizard.py:182-184,219-249。選択肢は「不明な送信者を丁寧に拒否する(1回だけメッセージを送り、その後は応答しない)」)。拒否メッセージはグローバル設定のみです(gateway/run_inbound.py:139)。discovery_concurrency:hermes_cli/config_defaults.py:526のデフォルトは4です。tools/mcp_tool_discovery.py:27-40には「mcp.discovery_concurrencyで上書きする。0 = 無制限(#117373)」とあります。整数でない値や負の値では「非負の整数ではありません。%dを使用します」とログに記録し、デフォルトを使います。接続を許可・拒否するゲートではなく同時接続数の上限であることは、tests/tools/test_mcp_tool.py:2813で固定されています(「同時接続数を制限する(並行処理は維持され、すべてのサーバーが接続する)」)。session_searchの範囲指定と再試行:tools/session_search_tool.py:578,621-635,708-725では、afterは「セッション開始時刻の下限(境界値を含む)。ISO形式の日付/日時(例:2026-06-01)、または相対期間(7d、24h、2w = 直近N以内)」、beforeは「セッション開始時刻の上限(境界値を含まない)。ISO形式の日付/日時(日付のみの場合は、その日のUTC午前0時)、または相対期間(7d = 1週間より前)」です。どちらも「検索対象の探索形式でのみ使用」し、「sortは順位付けの重み付けであり、範囲制約ではない」とされています。スキーマの安定性を保つため、新しいパラメーターは「detailの後に追加」されています。OR条件に緩和して再試行する処理はhermes_state_search.py:1151-1163にあり、コメントには「語句間の暗黙のANDにより、複数語で言い換えたクエリでは、たった1語でも欠けている保存済みの文を検索できない……完全なクエリと部分文字列のフォールバックがすべて不一致になったら、いずれかの語に一致する条件でunicode61インデックスを再検索する。……結果が0件の場合にのみ実行し、ヒットがある場合は完全一致の意味を保つ。明示的なOR/NOT、単一語、CJK向けの経路に振り分けられたクエリには手を加えない」とあります。専用のテストスイートはtests/hermes_state/test_search_or_relaxed_fallback.pyです。set-journal-mode:パーサーはhermes_cli/subcommands/sessions.py:177にあり、ヘルプには「オフラインでstate.dbをjournal_mode=WALとDELETEの間で変換します(保持しているすべてのプロセスを停止する必要があります)」とあります。hermes_cli/sessions_cmd_journal_mode.pyのdocstringでは、#100896に対するオフラインのセルフサービス手段とされています(それ以前は「文書化されていないPRAGMA journal_mode=DELETEを手動で実行することが唯一の脱出手段」でした)。「他のプロセスが1つでもファイルまたはサイドカーファイルを保持している間は拒否し(foreign_state_db_holders)、ファイルを開いているプロセスの終了を待たずに切り替え(_set_journal_mode_no_wait)、その後、SQLiteがモードに応じて書き込むヘッダーの18/19バイト目を検証する」とあります。ディスパッチには「オフライン:変換対象のストアを開いてはならない」と明記されています(hermes_cli/sessions_cmd.py:982)。hermes doctorは、デフォルト以外のストアに対して--db付きでこのコマンドを推奨します(hermes_cli/doctor_platform.py:148,163)。パーサーの説明には「gateway、ダッシュボード、すべてのCLIを停止してから実行してください。何らかのプロセスがファイルを保持している間は拒否し、モードを切り替えてファイルヘッダーを検証します」とあります。--forceのヘルプは「Windowsのみ:すべてのHermesプロセスを自分で停止したうえで、保持プロセスのスキャン(Windowsには存在しません)を行わずに続行します」です(hermes_cli/subcommands/sessions.py:176-189)。この制約は_refusalで適用されます(sessions_cmd_journal_mode.py:40-44:「Windowsでは保持プロセスのスキャンがないため、データベースが使用されていないことを証明できない」)。Desktopの一連の更新:フォント設定欄はapps/desktop/src/app/settings/chat-font-setting.tsx(CONFIG_PATH = 'desktop.font_family'、550 msで自動保存)にあり、themes/chat-font.tsと連携します(候補はOpenDyslexic、Atkinson Hyperlegible、Lexend、Inter、IBM Plex Sans、Source Sans 3、Noto Sans、Segoe UI、SF Pro Text。空欄の場合はテーマの書体を使います)。themes/context.tsx:279を通じて適用し、テーマトークン--dt-font-sansを上書きします。エンジン更新はapps/desktop/src/app/settings/local-models-settings.tsxとそのテストにあります(管理対象のローカルランタイムがupdate_availableを返すと「エンジンを更新」ボタンを表示し、進捗を報告するruntime-installジョブとしてinstallLocalRuntimeを実行します。テストでは「明示的な更新が失敗した場合、その状態を表示し続け、直接再試行でき、ステージング済みモデルがないこと」を確認しています)。Pluginsハブからのアンインストールはapps/desktop/src/app/capabilities/plugins/plugins-tab.tsxとそのテストにあります(「確認ダイアログで承認された後に限り、plugins.manage removeを通じてアンインストールする」。独立したDesktopプラグインはElectronローダーのuninstallDiskPluginを使います)。動画カタログ:plugins/video_gen/fal/__init__.py:43-44,99-101にはltx-2.5(「LTX 2.5」、「Lightricksのオープンソース音声・動画モデル。音声をネイティブに生成し、最大20秒 / 4K(i2v)、カメラモーションのプリセットに対応」。低価格帯、lightricks/ltx-2.5/text-to-video/fastと/image-to-video/fast、アスペクト比16:9/9:16、再生時間は整数。:128には「falはLTX 2.5の1440p/2160pで10秒を超える指定を拒否する」とあります)と、kling-o3(「Kling O3 (Standard)」、「Kuaishouの最先端モデル。複数ショットによるストーリー表現にネイティブ対応し、音声は任意、3〜15秒」。プレミアム価格帯、再生時間は3〜15を表す文字列、i2vでは画像からアスペクト比を取得し、generate_audioで実際に音声を切り替えられます)があります。ペイロードのテストはtests/plugins/video_gen/test_fal_plugin.py:641,681、一覧の行はwebsite/docs/reference/toolsets-reference.md:72にあります。カタログの拡充:plugin-catalog/は、v2026.9.14時点で9件のエントリーとremoved.yaml、v2026.9.21時点で228件のエントリーとremoved.yamlです。エントリーの構造はplugin-catalog/hermes-tailscale.yamlに準じます(name、repo、40桁の16進数のsha、description、maintainer、tier: community、category、docs_url、capabilities)。登録と公開のモデルはhermes_cli/plugin_catalog.py:4-10,33にあります(「正確な40文字のコミットSHAに固定する。ディレクトリに存在すること自体が」登録を意味します。website/scripts/extract-plugins.pyが/docs/api/plugin-catalog.jsonを公開し、LIVE_CATALOG_URLから取得して~/.hermes/cache/plugin-catalog.jsonにキャッシュします)。Webサイトのページはwebsite/plugins/plugin-catalog-pages/index.js(「/docs/plugins/にエントリーごとに1ページ」「/docs/plugins/by/にメンテナーごとに1ページ」「ページの追加・変更・削除は、カタログのPRがマージされた場合に限る」。サイトは「機能が低下することはあっても、失敗しない」)とreadme.jsに実装されています(各エントリーのREADMEは、shaを指定したraw URLを介して「固定されたコミットから」描画し、「ブランチの先端は決して使わない」ため、カタログのレビュー担当者が読んだREADMEとまったく同じものをページに表示します。ビルド時に許可リスト方式で描画し、生のHTMLは除去します。上限は512 KB、ホストはraw.githubusercontent.comとgitlab.comに限定されます。readme: falseで無効にできます)。作者のスラッグと、コミッター日時に基づく追加・更新日時はwebsite/scripts/extract-plugins.py:80,142にあります。リリースで名前が挙げられたコミュニティプラグイン10件すべてが、50に記載したスラッグのエントリーとして、このタグに存在します。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  52. Hermes Agent v0.21.5 リリースノート、タグ v2026.9.24、記載のリリース日は9月24日、公開日時は2026-09-24T10:09:38Zです。目的については次のように記載されています。「パッチリリースです。このタグは、v0.21.4以降にマージされた約460件のPRを、下流の利用者(Dockerイメージ、Hermes Cloud、ホスティング環境)向けの安定版タグ付きリリースにまとめたものです。この期間の変更を整理した完全なリリースノートは、v0.22.0に持ち越します。」タグのコミット f97608f178(「chore: v0.21.5をリリース(2026.9.24)」)で計測された統計は、「マージ以外のコミット1,610件」、「変更ファイル4,828件」(+164,132 / -149,440)、「マージ済みPR 460件」、「クローズ済みissue 475件」です。ローカルクローンでの確認では、コミット数と差分の数値を完全に再現できました(git rev-list --count --no-merges v2026.9.21..v2026.9.24 = 1,610、マージを含めると1,638、git diff --shortstat = 4,828ファイル、+164,132 / -149,440)。PRとissueの件数は独立に検証していません。本文の「意図的に詳述していない項目」の一覧には、NousとOpenRouterのカタログにあるGPT-6「Sol/Terra/Luna」とClaude Opus 5.5、gateway.standaloneによるprofileごとの停止・起動・再起動、DesktopのプラグインSDK関連の一連の変更が挙げられています。Hindsightへの言及はありません。更新方法は「hermes update(gitによるインストールの場合)、またはインストーラーのワンライナーを再実行」、イメージについては「このタグからビルドされます(nousresearch/hermes-agent:v2026.9.24)」と記載されています。 ↩↩↩

  53. タグ v2026.9.24のソースで確認したv0.21.5の項目です(ガイドv1.22、2026年9月24日)。Hindsight:コミット 4cbf862abe「chore(memory): 同梱のhindsightプロバイダーを削除(プラグインカタログへ移動)」(9月22日)は、このタグの祖先コミットです。タグ時点のplugins/memory/には7つのプロバイダーディレクトリ(byterover、holographic、honcho、mem0、openviking、retaindb、supermemory)があり、v2026.9.21時点の8つから減っています。コミット 73c598e319「build: hermes-agent[hindsight]の追加依存関係を削除」で、pyproject.tomlからも削除されました。plugin-catalog/hindsight.yaml:repo: https://github.com/vectorize-io/hindsight、maintainer: vectorize-io、tier: community、requires_hermes: ">=0.21.4"。移行:hermes_cli/memory_provider_migration.pyのdocstring(1〜14行目)には、「hermes update」と「エージェント初期化」の2つのフックが記載されています。75行目では「メモリプロバイダー’{name}’はコアから移動されました – カタログからプラグインをインストールしました」と出力します。recover_at_startup()(110行目)は「security.allow_lazy_installsに従う」関数で、hermes_cli/update_cmd_deps.py:535-536とagent/agent_init.py:1315-1316から呼び出されます。ディスク上の変更と確認コマンド:memory-providers.md:482-490。多重化:hermes_cli/gateway_multiplex_mode.pyの10行目には「明示的なfalseは廃止されています」、43〜44行目には「gateway.multiplex_profiles: falseは廃止されたため、trueに書き換えました」とあります(コミット b936546561、9月23日)。gateway.standalone:hermes_cli/profiles.py:979-982には、「DEFAULT profileはホストそのものであり、スタンドアロンにはなりません。ここにこのキーを設定すると、プロセスごとに1回警告します」とあります(コミット 0238c9d740)。一時停止:コミット 4c342c05de「ホストのマルチプレクサー配下で1つのprofileを停止・起動・再起動」、multi-profile-gateways.md:120-138, 233-244(「一時的な互換性維持用の仕組み」、「gateway.standaloneが優先されます」)。モデル:hermes_cli/models_catalog_static.pyのOPENROUTER_MODELSの32行目と36〜37行目(anthropic/claude-opus-5.5、openai/gpt-6-sol、-sol-pro、gpt-6-luna、-luna-pro)。162行目のnousリストは、このリストから生成されます。タグ時点のモデル選択用カタログにはgpt-6-terraというモデルIDがないため、ここではSolとLunaのみを記載しています。プロバイダー:314行目のCANONICAL_PROVIDERSを解析すると、エントリは39件です(ASTで集計、変更なし)。plugins/model-providers/のディレクトリ数は、v2026.9.21とv2026.9.24の両方で38個で、v2026.9.14時点の39個から減っています。コミット 998f614c7f「feat(providers): キー不要のopencode-freeプランを削除」(9月18日)でプラグインが削除されました。コミットメッセージには「OpenCodeの無料プランは、OpenCodeクライアント以外からの匿名アクセスに対してHTTP 403を返すようになりました」とあります。hermes_cli/auth.py:1255-1259には、opencode-free、free、opencode_freeに対してopencode-zenとopencode-goを案内するエラーが残っています。互換性:COMPAT_MANIFEST.md、compat_manifest.json、hermes_cli/plugin_compat.pyは、タグ時点にも、mainのaa8a33d22d(9月24日)にも存在します。git diff v2026.9.21 v2026.9.24 -- hermes_cli/plugin_compat.pyの出力は空です(COMPAT_REMOVAL_DATEは32行目、「真偽値リテラルのみ」のチェックは296〜303行目)。2つのマニフェストでは、削除されたplugins.memory.hindsightのエントリだけが除去されています(-7 / -12行)。 ↩↩↩↩↩↩↩↩

  54. Hermes Agent v0.21.6 リリースノート、タグ v0.21.6(v2026.M.D形式ではない最初のリリースタグ)、記載のリリース日は10月8日、公開日時は2026-10-08T11:51:57Zです。目的については次のように記載されています。「パッチリリースです。このタグは、v0.21.5以降にマージされた約2,100件のPRを、DockerとHermes Cloud向けの安定版タグ付きリリースにまとめたものです。この期間の変更を整理した完全なリリースノートは、v0.22.0に含まれます。」パイプラインについては次のように記載されています。「これは、新しい安定版リリースパイプラインで作成された最初のリリースです。1つの試行用ref、テスト済みのDockerイメージ、公開時の証跡タグを使用します。提供するのは、タグ、このGitHubリリース、Dockerイメージです。デスクトップアプリ、Termuxパッケージ、Microsoft Storeは当面現在のビルドを維持し、次回の一括リリースで更新します。」統計は「コミット 818c13beで計測」され、「マージ以外のコミット8,867件」、「変更ファイル8,342件」(+772,490 / -225,600)、「マージ済みPR 2,106件」、「クローズ済みissue 3,027件」です。GitHubの比較 v2026.9.24...v0.21.6では、マージを含めて9,180件のコミットが報告されています(今回は差分の数値をローカルで再現していません)。「意図的に詳述していない項目」の一覧には、「CLI、TUI、Desktopで話している間のリアルタイム文字起こし(stt.streaming)」、「音声による対話を専用モデル(auxiliary.voice_chat)にルーティングし、推論はデフォルトでオフ」、「profileごとのプラグインホストで実行するサードパーティ製プラグイン(plugins.isolation: host)」、「概要を先に表示するhermes status(--short、--full)」、「コア、Desktop、TUIにまたがる、差し替え可能な階層型言語パック」、「hermes modelでのローカルモデル対応と、Linux x64およびarm64でのllama.cpp CUDA対応」、「認証情報のアップロードとターミナルコマンド内の不可視Unicodeに対する承認フラグ」、「ボットトークンを確認して招待リンクを表示するDiscordセットアップ」、「統一されたKanbanワークフロー定義」、「activate.fish」、「カタログへのGPT-6.1 SolとClaude Sonnet 5.5 / Haiku 5.5の追加」、および「新機能」セクションで引用したDesktop関連の項目が挙げられています。セキュリティセクションには、一部抜粋で次のように記載されています。「4件すべての問題(TRA-725、TRA-726、TRA-727、TRA-728)を報告してくださったTenable Researchに感謝します」。「自動的なgit呼び出し(セッションのワークスペーススナップショット、サブエージェントのworktree、kanban、worktreeのクリーンアップ、hermes -w)により、最初のプロンプトより前に、信頼できないリポジトリ自身の設定で定義されたclean/smudge/processフィルタープログラムが実行される可能性がありました(#130661)」。「Fromヘッダー内の引用符で囲まれた表示名によって…攻撃者のメッセージが許可された送信者としてメールの許可リストを通過する可能性がありました(#125212)」。更新方法は次のとおりです。「Docker / Hermes Cloud:nousresearch/hermes-agent:stable(または:latest)。CLI(gitによるインストールの場合):hermes update、またはインストーラーのワンライナーを再実行してください。」 ↩↩↩↩↩↩

  55. v0.21.6の項目は、タグv0.21.6(コミット818c13be)のソースで検証済みです(ガイドv1.24、2026年10月11日)。STT:hermes_cli/config_defaults.pyは、初期値としてstt.streaming: False(「発話中の部分テキストをリアルタイムに表示(openai/xai/elevenlabs)。失敗時はファイルパスを使用」)とstreaming_model: "gpt-live-transcribe"(「発話途中の差分を返す唯一のモデル」)を設定します。音声ルーティング:auxiliary.voice_chatは、デフォルトで120秒の枠と"reasoning_effort": "none"を使用します。agent/voice_turn_route.pyのdocstringには、「音声ターン(CLIの音声入力、Desktop/TUIでの音声会話、メッセージングの音声メモ)は、セッションのメインモデルより高速なモデルで実行できます……ターン開始時にリクエストが音声モデルの圧縮しきい値に収まらない場合は、代わりにメインモデルで実行します」と記載されています。分離:hermes_cli/plugin_isolation.pyには、「in_process(デフォルト)はすべてのプラグインをHermesプロセスにインポートします……hostはサードパーティーのプラグインコードをその外部に保ちます。通常のプラグインはprofileごとに1つのプラグインホストプロセスに読み込まれ……Hermesとの通信はctxのみを介して行います……同梱プラグインはHermesとともに配布され、プロセス内で動作し続けます」と記載されています。config_defaults.pyは初期値としてplugins.isolation: "in_process"を設定します。メモリ:plugins/memory/にはbyterover、holographic、retaindbが含まれます(v2026.9.24では7ディレクトリ)。plugin-catalog/honcho.yaml(plastic-labs)、mem0.yaml(mem0ai)、openviking.yaml(volcengine)、supermemory.yaml(supermemoryai)は、すべてtier: communityです。hermes_cli/memory_provider_migration.pyは、8つの名前すべてを_LEFT_COREに設定しています(「以前はコアに同梱されていたプロバイダーです。無人実行時の同意は、これらのみを対象とします」)。互換性:hermes_cli/plugin_compat.pyのdocstringには、「そのレイヤーと、それを引き続き使用しているプラグインを報告していたスキャナーは削除されました」と記載されています。compat_report()は{}を返し、allow_deprecated_importsはソースツリー内のどこにも存在しません。COMPAT_MANIFEST.mdとcompat_manifest.jsonもありません。ステータス:hermes_cli/subcommands/status.pyは、--full/--all(「1画面の要約に代えて、すべてのセクションを表示します(キーは伏せられます)」)と--deep(「–fullを暗黙的に有効にします」)を定義しており、--shortはありません。言語:hermes_cli/config_language.pyには、「受け付ける言語の集合はagent.i18n.supported_languages()で、同梱カタログ、profileのオーバーレイディレクトリ、読み込まれたすべてのプラグイン言語パックで構成されます」と記載されています。locales/には17個の<lang>.yamlファイルと16個の<lang>.tui.yamlファイルがあります。プロバイダー:plugins/model-providers/には41ディレクトリがあります(v2026.9.24では38個で、lmstudio、solstice、tencent-tokenhubが追加されました)。hermes_cli/models_catalog_static.pyのCANONICAL_PROVIDERSは、どちらのタグでも39行です。同ファイルのOPENROUTER_MODELSリストには、anthropic/claude-sonnet-5.5、anthropic/claude-haiku-5.5、openai/gpt-6.1-sol、openai/gpt-6.1-sol-proが追加されており、いずれもv2026.9.24には存在しません。承認:tools/approval_detection.pyには、「curl/wgetでシークレットまたは認証情報のファイルをアップロードする(情報流出の可能性)」、「認証情報のファイルをパイプでcurl/wgetのアップロードに渡す(情報流出の可能性)」、「不可視または双方向のUnicode制御文字(難読化の可能性)」というルールがあります。cron:cron/store_health.pyには、「書き込み不能なcronストア(ENOSPC、EROFS、EACCES)の機能低下状態……各ストアディレクトリに対し、メモリ内レコードは1つのみです……probe_storeはhermes cron statusとhermes doctorでも使用されます」と記載されています。Discord:plugins/platforms/discord/onboarding.py(invite_url()、INVITE_PERMISSION_BITS。「Message Content Intentが無効のままです(この場合、Discordはボットの接続を拒否します)」)。Gitフィルター:tools/subagent_worktree.py(「チェックアウトはリポジトリで指定されたsmudgeフィルターを実行します。無効化できない場合は分離をスキップします」)は、hermes_cli._subprocess_compat.noninteractive_repo_git_envを介して対処し、hermes_cli/worktree_ops.pyには「無効化できない場合は拒否します」と記載されています。メール:plugins/platforms/email/adapter.pyには、「最初の<…>を取得する正規表現ではなく、parseaddrを使用します(GHSA-rxqh-5572-8m77)。RFC 5322の折り返しは先に展開します」と記載されています。ダッシュボード認証:hermes_cli/dashboard_auth/request_utils.pyには、「ここではクライアントが指定したX-Forwarded-Forを決して解析しません」と記載されています。ローカルランタイム:hermes_cli/local_runtime/binaries.pyは"cuda"をllamacpp-cudaに対応付けます。hermes_cli/models_local.pyはOllama、LM Studio、Ollama Cloudを扱います。activate.fishはリポジトリのルートにあります(「./activateのfish版」)。Kanbanワークフローの定義とDesktop関連の項目は、ソースで確認していません。 ↩↩↩↩↩↩↩↩↩↩↩↩

  56. Hermes Agent v0.21.7リリースノート、タグv0.21.7。記載されているリリース日は10月11日で、公開日時は2026-10-12T05:53:41Zです。タグのコミットは71d34bad「fix(release): ビルド一覧のレンダリングにR2認証情報を渡し、リリースを妨げないようにします」(2026-10-12T03:17:10Z)です。目的については、次のように記載されています。「パッチリリースです。このタグは、v0.21.6以降にマージされた約204件のPRを、デスクトップアプリ(macOS Apple silicon、Windows)、Microsoft StoreとMSIX、インストーラー、Docker、Hermes Cloud向けの安定版リリースにまとめたものです。この期間の変更を整理した完全なリリースノートは、v0.22.0に付属します」。統計は「コミット1fd18277時点で計測」されており、「マージを除く740コミット」、「変更された4,156ファイル」(+86,775 / -26,980)、「マージされた204件のPR」、「クローズされた69件のissue」です。GitHubの比較v0.21.6...v0.21.7では、マージを含めて777コミットと報告されています。ソースからのインストールに関する箇条書きには、次のように記載されています。「公式リポジトリのソースからインストールした環境は、mainの各コミットではなく、公開済みの最新vX.Y.Zリリースへ更新されます。最新リリースよりすでに新しい環境は、そのまま次のリリースを待ち、以前の状態に戻されることはありません。引き続き各コミットに追従するには、hermes update --set-channel mainを実行してください。フォークとミラーは引き続きmainに追従します。Store、MSIX、同梱デスクトップ版のインストールに変更はありません」。「設定 ▸ バージョン情報 ▸ 更新に、ソースからのインストール向けの更新チャンネル切り替え(安定版リリース / すべてのコミット)が追加され、更新ダイアログにも現在のチャンネルが表示されるようになりました」。「hermes chat --resume後と次のgatewayターンで署名付き思考が再送され、Bedrock Converseの推論モデルが再開したセッションで拒否されることもなくなりました」。「mainを使用するインストールでは、地域のファイアウォールが403を返す可能性のあるリリースレコードを取得しなくなりました。安定版の確認では、GitHubトークンが設定されていればそれを使用し(GITHUB_TOKENまたはgh auth login)、GitHubのレート制限をレート制限として報告します」。意図的にドキュメント化していない項目のリストには、ctx.runAction、ctx.pet.say、「プラグインがトークンを保持せずに済む、コアによるCodexリクエスト」、「プロンプトを再構築せずに、セッション途中でインストールしたskillをモデルに届ける仕組み」、「新規有料契約者向けのデフォルト画像生成経路としてのKrea 2 Medium Turboと、マネージドKreaがリクエストを拒否した場合のFALへのフォールバック」、デスクトップ更新の高速化、「固定したリビジョンだけをチェックアウトするインストール」、「Relayへ送出される圧縮マーカー」、そしてプラグインのmemory-shield、command-ledger、Memoria、Model Router、wyoming-voice-bridge、codex-account-switch、redlineが挙げられています。更新方法は次のとおりです。「デスクトップアプリ:自動更新されます。Microsoft StoreからのインストールはStore経由で更新されます。CLI:hermes updateを実行するか、インストーラーの1行コマンドを再実行してください。Docker / Hermes Cloud:nousresearch/hermes-agent:stable(または:latest)」。 ↩↩↩

  57. v0.21.7の項目は、タグv0.21.7のソースで確認済みです(コミット71d34bad、ガイドv1.25、2026年10月13日)。チャンネル:hermes_cli/subcommands/update.pyでは、--set-channel CHANNEL(「このインストールの更新チャンネルを永続化します(config.yamlのupdate.installs配下にインストールごとに記録されます)… 公式ソースのチェックアウトは、デフォルトで’stable’(公開済みの最新vX.Y.Zリリースの正確なコミット)を使用します。’main’はソースブランチを追跡します」)、--channel CHANNEL(「今回の実行に限りCHANNELを追跡します… ‘stable’と’canary’は公開済みリリースを、’main’はブランチの先端を選択します。ソースからのインストール専用です」)、--install-idを定義しています。hermes_cli/update_channel.py(「1つのconfig.yamlを複数のインストールで共有します(ホスト、docker gateway、デスクトップのすべてが同じ~/.hermesをバインドマウントします)。そのため、ホーム全体で共有するupdate.channelキーは安全ではなく、存在しません」「未設定の公式チェックアウトはstableを追跡し、フォークとミラーはmainを維持します」。_tracks_official_origin:「フォーク、ミラー、ローカルパスのoriginは公式リリースを公開しません」)。hermes_cli/source_releases.py(「昇格済みのソースリリースを解決します。Gitタグから公開済みと推測することはありません」。_head_containing:「明示的に選択されていないデフォルト設定によって、推測だけでチェックアウトを過去に戻してはなりません。そのため、関係が不明な場合(履歴が浅い、GitHubに到達できない場合)はHEADを維持します」。「地域別のWAF」による403で確認を「停止してはなりません」。「通信障害では原因を明示します(レート制限は『リリースがない』という意味ではありません)」。「トークンが拒否された場合は匿名で再試行します」。GITHUB_TOKENとgh auth loginに関する表現は、リリースの記述に従っています)。デスクトップ:apps/desktop/src/app/settings/update-channel-row.tsxとapps/desktop/src/i18n/en_update_channel.ts(タイトルは「更新チャンネル」、説明は「安定版では公開済みリリースのみをインストールします。全コミットでは、変更が反映されるたびにmainブランチを追跡します」、選択肢は「安定版リリース」と「全コミット」です)。推論:agent/anthropic_thinking_policy.py(「thinkingブロックに上流で検証される署名が含まれる経路では、署名付きブロックを再送します」)。agent/anthropic_thinking_replay.py(「拒否された不透明な署名値やデータ値については、フィンガープリントのみを永続化し、再構築した各リクエストのコピーから該当ブロックを除外します。コンテキストの選択やプロセスの再開時に、後から正規の履歴を使って再構築することがあるため、この処理は直後の再試行以外でも必要です」)。agent/bedrock_adapter.py(「永続化されたreasoning_detailsのthinking… ConverseではtoolUseより前に推論を配置する必要があります」「Converseでのモデルごとの推論再送」)。メモリ:plugins/memory/にはbyteroverとretaindbが含まれます(v0.21.6ではディレクトリが3つありました)。plugin-catalog/holographic.yaml(repo: https://github.com/itpartypattaya/hermes-plugin-holographic、tier: community、requires_hermes: ">=0.21.5")。hermes_cli/memory_provider_migration.pyの_LEFT_COREには、引き続き8つすべての名前が記載されています。カタログ:plugin-catalog/には552件のYAMLエントリーが含まれます(GitHubのコンテンツAPIによると、v0.21.6では493件でした)。このタグでも変更されていない項目は、プロバイダーディレクトリ41個、静的な行39行、コアのロケールカタログ17個とTUIのロケールカタログ16個、22行のスタブであるhermes_cli/plugin_compat.py、そして--full/--allと--deepのみを備えるhermes statusです。デスクトップのアクション:apps/desktop/src/contrib/plugin.tsにctx.runAction?.('view.showBrowser')が記載されています。Relay:agent/relay_compaction.py(「hermes.compactionレコードを、所有元セッションのスコープスタック上にNeMo Relayのマークとして出力します」)。ソース内では見つからず、リリースノートに基づく項目は、ctx.pet.say、コアが生成するCodexリクエスト、セッション途中のskill、Kreaのデフォルト設定とFALへのフォールバック、バージョンを固定したインストールでのチェックアウト、デスクトップの更新高速化です。 ↩↩↩

  58. Hermes Agent v0.22.0リリースノート、タグv0.22.0、記載上のリリース日は2026年10月13日、公開日時は2026-10-14T03:21:46Zです。タグのコミットはe06df9c2「fix(desktop-e2e): コアのオンボーディング仕様で、トライアルなしのプロバイダー設定をカバーします」(2026-10-13T22:07Z)です。統計行の記載内容:「v0.21.0以降: 約24,200コミット · 約6,080件のPRをマージ · 約15,600ファイルを変更 · 約2,045,000行を追加 · 約1,140,000行を削除 · 約7,180件のIssueをクローズ · 約2,520人の貢献者」。「今回のリリース対象期間はHermes史上最大で、v0.21.0のサイクルの約2.5倍に相当します。v0.21.1~v0.21.7のパッチリリースをまとめ、その内容をすべて文書化しています」。GitHubの比較v0.21.7...v0.22.0では、756コミットと報告されています。上記で使用した引用:オンボーディングは「無料トライアルモデル(nous/welcome、OSユーザーごとに1回)で動作するため、キーは不要です。設定をスキップで終了し、設定 → オンボーディングを再実行で再開できます」。また、「CLI、TUI、gatewayにはアカウントも無料モデルも提供されません。HERMES_GUEST_ONBOARDINGは廃止されました」。コネクターについては、「デスクトップに新しいコネクターページが追加され、ホスト型アプリとMCPサーバーが1つの一覧に表示されます(MCPタブに代わるものです)」「nous.guest: falseでゲストIDを無効にし、tools.connectors.enabled: falseでコネクターを無効にします」。ローカルモデルについては、「ハードウェアに適したエンジン(CPU、CUDA、Metal、Vulkan、ROCm)でllama.cppをインストールし、維持管理します」「すべてのバックエンドがllama.cpp b11370を実行します」。パッケージについては、「WindowsにはApp InstallerまたはMicrosoft Storeを通じて署名済みMSIX(x64とARM64)が提供され、macOSにはApple Silicon向けの署名・公証済みビルドが提供されます」。アップグレード時の注意事項は、「管理対象のインストールではPython 3.14がランタイムです(パッケージマネージャーがインストールします)。KittenTTSは3.14では利用できません」「Windowsデスクトップ版はMSIXのみで、Windows 11 22H2以降が必要です。NSIS/MSIインストーラーは廃止されました」「デフォルトでは1台のマシンにつき1つのgatewayを使用します。」「session_resetのidle/dailyモードは廃止されました(これらを引き続き指定している設定では警告がログに記録されます)」「sessions.auto_pruneはデフォルトで有効になりました。終了済みで90日間非アクティブなセッションは、起動時に削除されます」「旧プラグイン互換インポート層は削除されました」「hermes sync(Skill Sync)は削除されました」「同梱のtirithスキャナーは削除されました」「複数のツールが改名されました(todo → todo_list、cronjob → cronjob_manage、process → process_manage)。旧名称も引き続き使用できます」です。カタログは「600件のエントリーに増加しました」。モデルは「Claude Fable 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5、GPT-6 Astra、Sol、Lunaに加え、GPT-6.1 Sol、Gemini 4 Argon」です。Bot Screenは「デフォルトでは無効で、ホスト側のパッケージが必要です」。サブエージェントは「CLI(F6)、TUI(Ctrl+T)、デスクトップで、入力欄の上に表示されます」。コードベースは「ソースが約106万行から69万8千行に減少し(−34%)、gateway/run.pyは34,847行から5,512行に縮小しました」。取り消された変更については、「Collective Wisdom V1(ソースツリー内の組織向けskillマーケットプレイス)はマージ後に削除されました。このリリースにwisdomのコードは含まれていません」。更新経路の記載内容:「Docker:完全なChromiumを備えた、バージョン固定のDebian 13ベースです。stable/latestが更新されるのは、リリースが公開されたときだけです」。 ↩↩↩↩↩↩↩

  59. v0.22.0の項目は、タグv0.22.0のソースで確認しました(コミットe06df9c2、ガイドv1.26、2026年10月14日)。オンボーディング:hermes_cli/welcome_trial.py(「デスクトップの初回お試し機能:初回インストール時にnous/welcomeで無料の推論を利用できます。OSユーザーごとに1回限りです」)、apps/desktop/src/app/settings/onboarding-settings.tsx(「詳細設定 → オンボーディングを再実行」)。HERMES_GUEST_ONBOARDINGはapps/desktop/electron/updater/channel-protocol.tsのRETIRED_BUNDLE_ENV_KEYSに含まれています。initiate-setupを呼び出す箇所は残っていません。tools/set_theme_tool.pyはset_themeを登録しています(アクセントカラー、ライト/ダーク/システムモード、レイアウトプリセット。「シンプルモードでは」シンプルなレイアウト「のみを表示します」)。コネクター:hermes_cli/subcommands/connectors.py(「ホスト型アプリのコネクターとそのアカウントを管理します」)、ui-tui/src/app/slash/commands/core.tsの/connectors。hermes_cli/config_defaults.pyはtools.connectors.enabled: Trueを初期値として設定します(「このフラグはユーザーが機能をオフにするためのスイッチです。利用するには、すべての管理対象ツールで必須となるポータルへのサインインも必要です」)。nous.guestはtools/connectors/gateway/config.pyで読み込まれます。hermes_cli/subcommands/auth.pyにはhermes auth upgradeがあります(「コネクターを保持したまま、Nousアカウントでサインインします」)。ローカルモデル:hermes_cli/model_setup_flows_local.py(「hermes model → ローカルモデル:デスクトップのローカルモデル設定をターミナルで行います」)。hermes_cli/local_runtime/catalog.jsonにはqwen3.8-27b、qwen3.8-flash-next、qwen3.6-35b-a3b、deepseek-v4-flashが記載されています。pm/lock.jsonはプラットフォームごとにllama.cppのb11370ビルドを固定しています。パッケージマネージャー:pm/cli.pyはdoctor(「インストール済みの状態をロックファイルと照合します」)、repair(「依存関係グラフを変更せずに、記録済みの依存環境を再構築します」)、gc(「どこからも参照されていないストア内の項目を削除します」)、status(「最新のpm syncの実行記録を表示します」)を定義しています。hermes_cli/main.pyはhermes pmの処理をそこに渡します。pm/install.pyはsecurity.allow_lazy_installsを読み込みます(デフォルトはtrue)。pm/lock.jsonはcpython-3.14.7+20260901に固定していますが、pyproject.tomlではrequires-python = ">=3.11,<3.15"と宣言されています。hermes_cli/config_defaults.pyのデフォルト値:sessions.auto_prune: True、agent.turn_liveness: {timeout_s: 600.0, poll_s: 15.0}、agent.auto_recovery_cycles: 5、prompt_caching.cache_ttl: "5m"(コメントでは"auto"も許容されています)、mcp.discovery_concurrency: 4、plugins.isolation: "in_process"、display.tui_native: False、display.suppress_warning_notifications: False、skills.auto_load: []、およびtelemetry.shared_metricsブロック。display.vim_modeはhermes_cli/cli_init_mixin.pyで読み込まれます(「設定ファイルからのみ指定可能です」)。bell_on_promptはui-tui/src/app/createGatewayEventHandler.tsで、ステータスフィールドgit_branchはhermes_cli/cli_status_bar_mixin.pyで読み込まれます。hermes_cli/_parser.pyは--native/--tui-nativeと-z/--oneshotを定義しています。gateway:hermes_cli/gateway_multiplex_mode.py(「gateway.standalone: trueは後方互換性を保つための一時的な仕組みであり、サポート対象の構成ではありません」「hermes gateway migrate --multiplexでこのprofileを統合する計画を立ててください」)。hermes doctorはhermes_cli/session_reset_retirementを通じて「セッションリセット(タイマーは2026年9月7日に削除済み)」のチェックを実行します。サブエージェントモニター:hermes_cli/cli_tui_mixin.pyはc-tとf6にキー操作を割り当てています。ui-tui/src/content/hotkeys.tsはCtrl+TをexpandAgentsに割り当てています。ツール:tools/todo_tool.pyはtodo_listを登録しています(toolsetはtodo)。tools/mcp_oauth_provider.py(「MCPのデバイス認証にはhermes mcp login <server> --flow deviceが必要です」)。tools/bot_desktop/sandbox_host.pyはnousresearch/hermes-sandbox:desktopを指定しています。tools/voice_live.pyにはvoice.voice_chat_mode: gpt-liveの説明があります。hermes_cli/subcommands/cron.pyは--pausedと--interpreterを受け付けます。hermes_cli/subcommands/usage.pyはhermes usage --jsonのドキュメントを出力します。削除項目:hermes_cli/config_migrations.pyの49から50へのマイグレーションでは「security.tirith_*を削除しました(スキャナーは同梱されなくなりました)」。hermes_cli/subcommands/にsyncサブコマンドはありません。hermes_cli/plugin_compat.pyはv0.21.7と同じ22行のスタブのままです。タグ時点の件数:plugin-catalog/にはYAMLの項目が601件あります(リリースでは600件と記載されています。v0.21.7では552件でした)。plugins/model-providers/は41ディレクトリ、CANONICAL_PROVIDERSは39行で、どちらもv0.21.7から変更はありません。plugins/memory/にはbyteroverとretaindbがあります。locales/にはコア用17個、TUI用16個のカタログがあります。ソースでは見つからず、リリースの記述に基づく項目:ウェルカムチャットのカードの表示順序、MCPタブに代わるコネクターページ、Bot Screenのホストパッケージ、106万行から69万8,000行への行数の削減、/queueの編集インターフェース、/steerのエイリアスとしての/sです。 ↩↩↩↩↩↩↩↩↩↩

  60. Hermes Agent v0.22.1リリースノート。タグはv0.22.1、タイトルは「Hermes Agent v0.22.1 (rc.5-v0.22.1)」、記載されたリリース日は2026年10月14日、公開日時は2026-10-14T23:59:24Zです。タグのコミットは297552a9で、件名は「fix(compression): フォールバック要約、複数行のセットアップメモ、並列読み込みでskillマーカーを正しく保持します」(2026-10-14T21:56:35Z)。説明文の全文は「これはパッチリリースで、Windows Storeやプラグインの更新などに関するいくつかの修正を含みます」です。本文の残りは、リンク付きのコミット件名を自動生成した一覧です。「機能」に111件、「改善」に21件、「バグ修正」に315件、「ドキュメント」に28件、「テスト」に121件、「インフラストラクチャ」に41件、「その他の変更」に22件があり、貢献者も記載されています。生成処理ではConventional Commitsのプレフィックスが取り除かれるため、項目は「Cli): モデル選択リストの先頭に厳選モデル一覧を追加します」「Agent): nemotron super 3.5のデフォルトパラメーターを追加します」「nemotron super 3.5の名前を更新します」「Plugin-catalog: hermes-lang-pt-br(ブラジルポルトガル語の言語パック)を追加します」「Plugin-catalog: teamorouter(TeamoRouterのモデルプロバイダー)を追加します」「Plugins): Kumiho Memoryをメモリーカタログの棚に移動します」「検証済みのPythonパイプを通じてWindowsデスクトップのチケットを初期設定します」といった表記になっています。GitHubの比較v0.22.0...v0.22.1では2,216コミットと報告されています(コミッター日時は9月24日から10月14日)。v0.22.0はmainの祖先にあたり、執筆時点のmainはv0.22.1より66コミット先に進んでいました。 ↩↩↩↩

  61. v0.22.1の項目は、タグv0.22.1のソースで確認しました(コミット297552a9、ガイドv1.27、2026年10月14日)。plugin-catalog/にはYAMLの項目が614件あります(v0.22.0では601件)。これにはhermes-lang-ko.yaml、hermes-lang-pt-br.yaml、teamorouter.yaml、author-feed.yaml、wait-ledger.yaml、lightningai.yaml、lightningai-rate-limit.yaml、hermes-aac.yaml、openinvest.yaml、hermes-agent-mixer.yaml、kumiho-memory.yamlが含まれます。モデル選択:hermes_cli/model_setup_flows_common.pyの_models_dev_merged(「厳選したIDを先に並べます(エージェント用途の推奨モデルを先頭に置き、models.devの更新が遅れても新しいモデルが表示されるようにします)。その後は、厳選リストの順序よりもmodels.devの順序を優先します」)。また、_LIVE_FIRST_PICKER_PROVIDERSセットでは、ライブ取得した順序を優先します。カタログ:hermes_cli/models_catalog_static.pyにnvidia/nemotron-3.5-super-vl-120b-a12bが記載されています。圧縮:website/docs/developer-guide/context-compression-and-caching.mdに「圧縮をまたいだ読み込み済みskillの保持」セクションが追加されました。タグのコミットとその前後のコミット(71e815de、a36fb64f、d6020828、036c31d2)には、skillマーカーに関するfix(compression)の変更が含まれています。v0.22.0から変更がない項目:plugins/model-providers/は41ディレクトリ、CANONICAL_PROVIDERSは39行、plugins/memory/にはbyteroverとretaindb、locales/にはコア用17個とTUI用16個のカタログがあり、hermes_cli/plugin_compat.pyは22行です。一覧以外では確認できなかった項目:説明文で挙げられているWindows Storeの修正です。 ↩↩↩

  62. Hermes Agent v0.22.2 リリースノート、タグ v0.22.2(注釈付きタグ 7b77e29e が指すコミットは d923a5eb「公開済みの v0.22.1 を親として release/0.22.1 から 0.22.2 をリリース」、2026-10-15T05:52:56Z)、記載のリリース日は2026年10月15日、公開日時は2026-10-15T08:21:32Zです。冒頭の引用:「v0.22.1 は誤ったコミットからビルドされました。未リリースの gateway の変更が含まれており、Microsoft Store アプリが『Connecting』のまま動かなくなることがありました。0.22.2 は、本来 0.22.1 としてリリースされるはずだったものです」。既知の問題の引用:「0.22.1 の gateway で実行したセッションは、0.22.2 では削除できません」。主な変更点の引用:「再起動後に gateway が再び起動するようになりました。再起動後、Linux が起動初期の PID を無関係なプロセスに割り当てると、gateway がそれを実行中の gateway と誤認し、監視下の gateway(systemd、launchd、Docker)が起動を拒否することがありました。Hermes は起動時のブート情報を記録するようになり、判別できない場合は、稼働中の gateway だけが保持するホストロックを確認します」(#138594、#133744 を修正);「ノートパソコンでもローカルモデルによる長時間のターンを継続できるようになりました。ローカルリクエストは常にストリーミングされ、プロンプトの読み取り状況がステータス行に表示されます。停止検出タイマーはマシンがスリープしていた時間を除外し、ローカルサーバーが復旧すると再試行します。従来のように、ブレーカーによって以降のメッセージがすべて失敗することはありません。また、サーバーが長い会話を読み取っている間に圧縮がタイムアウトすることもなくなりました。ユニファイドメモリを搭載した Windows マシンでは、モデル起動時の設定とプロンプトキャッシュのサイズを空きメモリに合わせます」(#138560)。「以下は、v0.22.0 以降の 0.22 リリース系列に含まれるすべての変更です。0.22.1 で提供する予定だった修正に、上記2件を加えています。main にのみ存在する変更は v0.23.0 で提供します」。更新手順の引用:「CLI およびインストーラースクリプトによるデスクトップインストール:hermes update を実行するか、1行のインストーラーコマンドを再実行してください。これにより、v0.22.1 を導入した環境がリリース系列に戻ります」。掲載内容は、新機能19項目、改善7項目、バグ修正58項目、ドキュメント8項目、テスト9項目、インフラストラクチャ31項目、その他の変更35項目、貢献者49人です。GitHub の比較 v0.22.1...v0.22.2 では11コミット(10月14日付の fix(gateway) および fix(local) コミット7件、マージ2件、リリースコミット)が報告されています。リリース系列の比較 v0.22.0...4ccc5806 では179コミットが報告されています。v0.22.2 は main の祖先であり、10月17日時点で main はそこから1,531コミット先に進んでいました。 ↩↩↩↩↩↩↩↩

  63. v0.22.2 は、v0.22.0、v0.22.1、v0.22.2 の完全な git ツリーを再帰的に比較し、タグ v0.22.2(コミット d923a5eb;ガイド v1.28、2026年10月17日)のソースで検証しました(比較用 API のファイル一覧は300件が上限のため、変更の大部分が表示されません)。v0.22.1 から v0.22.2 への変更は、blob の追加60件、削除1,135件、変更846件です。削除のディレクトリ別内訳は、tests/gateway/ 配下466件、apps/desktop/ 配下132件、gateway/ 配下118件(session_authority.py、session_admission.py、runtime_ownership.py、run_* および hosted_room_* モジュール)、hermes_cli/ 配下47件(gateway_runtime*.py、gateway_client.py、kanban_worker_client.py、sessions_owner.py、update_downgrade_guard.py)、最上位の hermes_state_*.py モジュール21件、agent/managed_worker.py、agent/runtime_session_store.py、agent/context_compressor_tail.py、acp_adapter/gateway_server.py です。追加されたのは、agent/auxiliary_managed_local.py、agent/chat_completion_local.py、agent/conversation_compression_deadline.py、agent/local_prompt_progress.py、agent/model_metadata_llamacpp.py、agent/sleep_clock.py、およびデスクトップのバックエンドプールとスリープ防止用のファイルです。v0.22.0 から v0.22.2 への変更は、追加50件(カタログ項目13件、6つの agent/ モジュール、hermes_cli/profile_model_seed.py、pm/user_facing.py、scripts/releases/lanes.py、テスト、貢献者の対応表)、削除1件、変更205件です。v0.22.2 でも維持されている内容は、plugin-catalog/ の YAML 項目614件;v0.22.1 と同一の hermes_cli/model_setup_flows_common.py および hermes_cli/models_catalog_static.py(選定済み項目を優先する _models_dev_merged、nvidia/nemotron-3.5-super-vl-120b-a12b);plugins/model-providers/ の41ディレクトリ;同一の hermes_cli/providers.py(39行);plugins/memory/ の byterover と retaindb;locales/ のコア用17カタログと TUI 用16カタログ(全35ファイルの内容が変更され、追加・削除はありません);22行の hermes_cli/plugin_compat.py です。v0.22.2 に含まれないのは、v0.22.1 のタグが指すコミットにある agent/context_compressor.py の該当行(「そのスタブ自体の判定を保持します」)と agent/skill_commands.py の該当行(_TRAILING_BLOCK_ENDS)、および website/docs/developer-guide/context-compression-and-caching.md の「圧縮をまたいで読み込まれた skill」セクションです。 ↩↩↩↩

  64. Hermes Agent リリースノート v0.22.3(タグが指すコミットは 5b147ab0「fix(ci): Docker のマニフェストリストのジョブを GitHub ホスト型ランナーで再び実行」、2026-10-21T11:14:29Z;記載のリリース日は10月21日、公開日時は2026-10-21T12:21:11Z)、v0.22.4(タグが指すコミットは 4d043038、2026-10-21T16:16:45Z;公開日時は2026-10-21T18:49:24Z)、および v0.22.5(タグが指すコミットは bf0203a7「fix(launchers): Python のバージョン固定をやり直す際に、.cmd ではなく hermes.exe を再公開」、2026-10-23T02:24:27Z;記載のリリース日は10月22日、公開日時は2026-10-23T05:28:45Z)。v0.22.3 の引用:「パッチリリースです。このタグは、v0.22.2 以降にマージされた約620件の PR を、CLI とインストーラー、Microsoft Store アプリ、Docker、Hermes Cloud 向けの安定版リリースにまとめたものです。この期間の変更を整理した完全なリリースノートは v0.23.0 で提供します」;「コミット 5b147ab036d 時点で集計すると、v0.22.2 以降の期間には、変更ファイル4,206件にわたるマージ以外のコミット2,911件(+360,278 / -64,308)、約620件のマージ済み PR、326件のクローズ済み issue が含まれます」。「この期間に含まれますが、ここでは意図的に記載していない変更」の一覧は本文のセクションで引用しています。v0.22.4 の引用:「デスクトップでは、入力欄の上に提案チップが表示されなくなりました。これらのチップは明確な理由もなく表示され、主に MCP サーバーの設定を促していました」(#142559);「何もインストールしないプラグインでは、依存関係のインストールに同意する手順を省略します」(#142569);「プラグインカタログには、bubblewrap(Linux の bwrap ターミナルバックエンド)、Singularity/Apptainer、mcp-serve(Hermes を MCP サーバーとして動作させます)、agent-importers(hermes import-agent、Cursor にも対応)、Hermes Labs の inbox と workflow-record も新たに加わりました。Telegram Business は Hermes Labs のコミュニティ階層に移ります」;「v0.22.3 以降の期間には、変更ファイル82件にわたるマージ以外のコミット14件が含まれます」。v0.22.5 の引用:「このタグは、v0.22.4 以降にマージされた約81件の PR をまとめたものです」;「コミット bf0203a794a 時点で集計すると、v0.22.4 以降の期間には、変更ファイル804件にわたるマージ以外のコミット231件(+35,212 / -17,885)、81件のマージ済み PR、30件のクローズ済み issue が含まれます」。意図的に記載していない変更の一覧は本文のセクションで引用しています。3つのリリースに共通する記載:「インストーラー(.exe / .dmg)からインストールしたデスクトップアプリ:このリリースでの変更はありません。次のバンドル版リリースで更新されます」。GitHub の比較 v0.22.2...v0.22.5 では、3,291コミット先に進んでいると報告されています。v0.22.5 は main の祖先であり、10月23日時点で main はそこから459コミット先に進んでいました。 ↩↩↩↩↩↩

  65. タグ v0.22.5(コミット bf0203a7、ガイド v1.29、2026年10月23日)のソースで、v0.22.2、v0.22.3、v0.22.4、v0.22.5 の git ツリー全体を再帰的に比較し、v0.22.5 を検証しました。Blob 数:v0.22.2 から v0.22.3 では追加 2,154、削除 71、変更 2,001、v0.22.3 から v0.22.4 では追加 14、削除 14、変更 54、v0.22.4 から v0.22.5 では追加 136、削除 25、変更 643、v0.22.2 から v0.22.5 では追加 2,303、削除 109、変更 2,298 でした。v0.22.5 時点の件数:plugin-catalog/ は YAML エントリ 763 件(v0.22.2 時点では 614 件、150 件追加、codex-account-switch.yaml を削除)、plugins/platforms/ は 27 ディレクトリ(bluebubbles、qqbot、signal、weixin、whatsapp_cloud、yuanbao が新規)、plugins/model-providers/ は 41、plugins/memory/ は byterover と retaindb、locales/ はコア用カタログ 17 件と TUI 用カタログ 16 件、hermes_cli/plugin_compat.py は 22 行、hermes_cli/models_catalog_static.py の CANONICAL_PROVIDERS は 39 行です。v0.22.5 の hermes_cli/config_defaults.py:sessions ブロックには「# auto_prune キー。state.db を保存するディスクの空き容量が少なくなると、各インターフェースで確認します」と "auto_prune": False が記載されています(v0.22.2 では True でした)。ツリーから削除されたもの:mcp_serve.py(ルート)、hermes_cli/claw.py、hermes_cli/subcommands/claw.py、hermes_cli/subcommands/import_agent.py、hermes_cli/agent_import.py、hermes_cli/agent_import_sync.py、hermes_cli/setup_whatsapp_cloud.py、optional-skills/migration/openclaw-migration/。hermes_cli/subcommands/mcp.py には現在、「Hermes 自体を MCP サーバーとして実行するには、mcp-serve プラグインを使用します:hermes plugins install mcp-serve」と記載されています。このタグのカタログカード:mcp-serve.yaml(「以前は hermes mcp serve として Hermes コアに組み込まれていました(MCP クライアントは引数を ["mcp-serve"] に変更します)」)、agent-importers.yaml(「hermes import-agent:OpenClaw(~/.openclaw、または旧来の ~/.clawdbot / ~/.moltbot)、Claude Code(~/.claude)、Codex CLI(~/.codex)、Cursor(~/.cursor)の設定を、1 つのコマンドで Hermes にインポートします。必ず最初にプレビューを表示し、適用前に確認します」、「OpenClaw(以前コアにあった hermes claw migrate。プラグインでもこのコマンド表記、hermes claw cleanup、openclaw-migration skill を維持しています)」、「hermes setup は該当する設定を検出すると、このプラグインのインストールを提案します」)、bubblewrap.yaml(「Linux 向け Bubblewrap ターミナルバックエンド …(hermes config set terminal.backend bubblewrap)」)。追加されたもの:agent/delegation_backends.py、agent/delegation_provider.py、agent/delegation_registry.py、website/docs/developer-guide/delegation-provider-plugin.md。 ↩↩↩↩↩↩↩

  66. Hermes Agent v0.22.6 リリースノート(タグが指すコミットは f0d94882「test(install-e2e): v2026.7.30 の macOS DMG アプリ更新の拒否を既知の問題として分類」、2026-11-02T15:57:32Z;記載のリリース日は11月2日、公開日時は2026-11-02T17:18:36Z)。引用:「パッチリリースです。このタグは、v0.22.5 以降にマージされた約776件の PR を、GitHub リリース(CLI とインストーラー)、Microsoft Store アプリ、Docker、Hermes Cloud 向けの安定版リリースにまとめたものです。この期間の変更を整理した完全なリリースノートは v0.23.0 で提供します」;「コミット f0d94882e89 時点で集計すると、v0.22.5 以降の期間には、変更ファイル4,316件にわたるマージ以外のコミット3,448件(+248,579 / −94,077)、776件のマージ済み PR、385件のクローズ済み issue が含まれます」;「この期間に含まれますが、ここでは意図的に記載していない変更」の一覧には、「gateway 自身のリスナーから配信される Webapp(hermes webapp、自分のネットワーク上または独自の URL で Nous のサインインを経て開くための Desktop の Web Access ペイン、ブラウザーのタブで読み込まれる Desktop プラグイン)、履歴を失わずにセッションのモデル固定を解除する /model reset、自律的な書き込みに対する skill ごとのロック(Desktop の Capabilities ペインからロック可能)、オプトインの事前準備付きコンパクション(compression.prepare_ahead)、hermes cron cancel とジョブごとの実行漏れポリシー、Desktop の cron エディターの Stop ボタン、次のセッションに引き継がれる /delegation の選択、Grok Bot と OpenBot のユーザーを移行する hermes migrate とセットアップ、保管庫キーのオプトインの OS キーチェーン保存、プラグインのインストール時と更新時に適用されるカタログの requires_hermes、text_to_speech でエージェントが選ぶ ElevenLabs の音声、推論の前にターンをブロックできる pre_llm_call フック、Desktop のグループチャットの名前変更、解散、メンション、添付ファイルの貼り付け、Desktop のサイドバーのセクションとして表示されるすべての profile、Telegram のビデオノート、スレッドのコンテキストに含まれる Slack の絵文字リアクション、パッケージマネージャーの再開可能なダウンロード」が挙げられています。更新方法の引用:「インストーラー(.exe / .dmg)からインストールしたデスクトップアプリ:このリリースでの変更はありません。次のバンドル版リリースで更新されます」。 ↩↩↩↩↩

  67. タグ v0.22.6(コミット f0d94882、ガイド v1.30、2026年11月2日)のソースで、v0.22.5 と v0.22.6 の git ツリー全体を再帰的に比較し、v0.22.6 を検証しました。Blob 数:追加 1,504、削除 237、変更 2,646。v0.22.6 時点の件数:plugin-catalog/ は YAML エントリ 911 件(v0.22.5 時点では 763 件、148 件追加、削除なし)、plugins/platforms/ は 27 ディレクトリ、plugins/model-providers/ は 39(copilot と copilot-acp が消滅)、plugins/memory/ は byterover と retaindb、hermes_cli/plugin_compat.py は 22 行、hermes_cli/config_defaults.py の sessions 配下は "auto_prune": False、hermes_cli/models_catalog_static.py の CANONICAL_PROVIDERS は copilot と copilot-acp の行を失い、残りは維持しています。Copilot:コミット 1da2eb42(2026-10-25)「refactor!: GitHub Copilot をコアから削除(現在は github-copilot labs プラグイン)」:「ツリー内のモデルプロバイダープラグイン plugins/model-providers/copilot/(プロバイダー copilot:GitHub->Copilot のトークン交換による Copilot API)と plugins/model-providers/copilot-acp/(プロバイダー copilot-acp:ACP 経由の Copilot CLI)を削除します。両方とも NousResearch/hermes-labs-plugins の1つのプラグイン github-copilot として提供されます。このコミットの前に追加された LEFT_CORE の行が、copilot/copilot-acp 経由で接続するすべての profile にこれをインストールし、『unknown provider』を表示するすべての箇所が hermes plugins install github-copilot を案内します」;hermes_cli/left_core_migration.py(「hermes update は、この機能を使い、venv を共有するすべての profile ホームにプラグインをインストールします。エージェントの起動と gateway の起動では、アクティブなホームに対してプロセスごとに1回再試行します」);plugin-catalog/github-copilot.yaml(tier: community、リポジトリは hermes-labs-plugins)。機能:hermes_cli/subcommands/webapp.py(ヘルプは「Hermes Desktop のワークスペースをブラウザーで開きます」;「config.yaml で webapp.enabled が true のとき、gateway がこれを配信します。このコマンドは必要に応じてバンドルをビルドし、gateway を起動して、1回限りのサインインリンクを開きます」;--no-open、--rebuild、--skip-build、--build-only、--status);gateway/slash_commands_model.py(「/model reset:このセッションの /model による上書きを解除します」);hermes_cli/curator.py(_set_lock:「hermes curator lock|unlock:pinned と並んで保存されるユーザーの宣言」;status は「エージェントはこれらを変更できません。hermes curator unlock <skill> で解除します」と表示)と tools/skill_lock.py;agent/agent_init.py(prepare_ahead=is_truthy_value(cfg.get("prepare_ahead"), default=False));cron/cancellation.py(「進行中の cron 実行のオンデマンドの取り消し(hermes cron cancel)」)と cron/missed_runs.py(「各ジョブは catch_up を持てます。true は逃したすべてに対して1回だけ補完実行し、false は次の実行枠まで飛ばします。キーがない場合、繰り返しジョブは cron.catch_up_missed(デフォルト true)に従い、単発ジョブは 120 秒の猶予ルールを維持します」;「実行台帳に missed ×N の1行として記録されます」);agent/delegation_backends.py(「config.yaml の delegation.backend が保存された選択です」);hermes_cli/migrate.py(「hermes migrate <agent>:agent-importers プラグインが未導入ならインストールし、その」インポーターを実行;「hermes migrate xai は参照を診断し、(–apply 付きで)書き換えます」)と hermes_cli/setup_agent_import.py(ソースは「Grok Bot」と OpenBot、「openbot.db を含む Electron のユーザーデータ」);hermes_cli/config_defaults.py(vault.key_storage: "file"、「新しい保管庫のキー:file(0600 の vault.key)| keychain(OS。なければ file)。hermes vault key を参照」)、hermes_cli/vault.py(「hermes vault key は保管庫のキーの保存場所を表示し、key migrate --to keychain|file はそれを移動します」)、agent/vault_keychain.py(「Linux では KWallet。keychain 追加機能に含まれる keyring パッケージ経由」);hermes_cli/plugins_cmd_catalog.py と hermes_cli/plugins_loader.py(requires_hermes_error);tools/tts_elevenlabs_voices.py(「text_to_speech の find_voices 引数の背後にある ElevenLabs の音声検索。この引数(および voice_id)は ElevenLabs 版にのみ存在します」;ソースは library と account);hermes_cli/plugins_dispatch.py(「pre_llm_call は、コンテキストを注入するために {"context": "..."}(または str)を返すか、推論リクエストの前にターンを終了するために {"action": "block", "message": "..."} を返せます」);plugins/platforms/telegram/adapter.py(video_note を MessageType.VIDEO に対応付け);plugins/platforms/slack/adapter_reactions_context.py;apps/desktop/src/plugins/hermes-bots/bot-row.tsx(onDisband)、apps/desktop/src/api/cron.ts(cancelCronJobRun)、apps/desktop/src/app/settings/web-access-settings.test.tsx;plugins/config_backends/remote/plugin.yaml(「config.yaml の代わりに、各 profile の設定を config-config プレーン(このインスタンスと profile に対するエージェントの実効ドキュメント)から配信します。起動時に取得し(失敗時は安全側に倒します)、ETag のポーラーで更新し、キー単位の変更として compare-and-swap で書き戻します。環境変数の HERMES_CONFIG_BACKEND=remote によってのみ選択され、一般的なプラグインとして読み込まれることはありません」)と hermes_cli/config_backend.py。タグ内で特定できなかったもの:パッケージマネージャーの再開可能なダウンロード。 ↩↩↩↩↩↩↩↩↩↩↩↩

  68. Hermes Agent v0.20.3 リリースノート(タグ v2026.8.16.2、記載上のリリース日は2026年8月16日、公開日は2026年8月17日)および v0.20.4 リリースノート(タグ v2026.8.18、2026年8月18日)。いずれも2026年8月20日に GitHub API 経由で取得しました(prerelease: false)。v0.20.3 の原文引用(訳):「MCP 2.x SDK への移行と 2026-07-28 ステートレスプロトコルへの対応、コアのチームメイトプロトコルを備えた同梱の Bot Mode(hermes-bots)プラグイン、CommandCode プロバイダープラグイン、サブプロセスの Python ランタイム所有権の強化(PYTHONHOME/PYTHONPATH の分離)、コンピューター操作向けの Cua Driver 0.20 ランタイム契約です」。v0.20.4 の原文引用(訳):「デスクトップのガラス・半透明表現の整備(マットガラス、フロストピッカー、macOS での事前選択)、ボットごとに表示・非表示を切り替えられるタブ式の SESSIONS|BOTS サイドバー、… skill インストール時の NVIDIA SkillEvaluator Tier 1 による助言目的のスキャン(ライセンスとセキュリティのチェック)です」。両リリースには「この期間の変更を整理した完全なリリースノートは、v0.21.0 とともに公開します」と記載されています。 ↩↩↩↩↩↩↩↩↩↩↩↩↩

  69. Hermes Agent v0.20.0 リリースノート、「The Herald Release」、タグ v2026.8.3、2026年8月3日。安定化タグは v2026.8.13 と v2026.8.16 です。リリースの原文引用(訳):「インストーラー・修復・アップグレードのすべてで Node 26 が必須です」、「brew と pip/PyPI wheel の配布チャネルは廃止されました(サポート対象はシェルインストーラー / Docker / Nix です)」、「デフォルトの反復回数上限を 90 → 500 に変更しました」、「claude-marketplace ソースを削除しました」。Node の最低バージョンは、インストーラーのソース scripts/install.sh にある NODE_VERSION="26" と、バージョンチェック時のメッセージ「Node.js $(node –version) は古すぎます(Hermes には Node >=26 が必要です)」でも独立して確認しました。同ファイルの冒頭コメントには、正式な 1 行のインストールコマンド curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash も記載されています。記載の不一致に注意してください。ドキュメントのインストールページには依然として Node v22 と書かれており、リリースノートとソースの両方に対して情報が古くなっています。プラットフォームのサポート区分はプラットフォームサポート、skill のソースとデフォルトの tap は skill を参照しました。28 プラットフォームという数は、メッセージングの比較表を数えて算出したもので、公式の総数は公表されていません。すべて2026年8月16日に取得・検証しました。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  70. Hermes Agent v0.19.0 リリースノート、「The Quicksilver Release」、タグ v2026.7.20、2026年7月20日。2026年7月21日時点の最新版です。v0.18.0 以降の統計:約2,245コミット、約1,065件のPRをマージ、約3,300件の課題をクローズ、450人以上のコミュニティ貢献者。性能改善の主な内容:初回ターンのTTFTを約80%短縮し、CLI/gateway/TUI/デスクトップ/cronでコールド状態の送信からディスパッチまでの時間を約4.3秒から約0.9秒に短縮しました(PR #59332)。display.show_reasoning をデフォルトでONにして推論をリアルタイムにストリーミングし、応答をトークンごとに描画します(PR #59389)。デスクトップでは約20件のPRで高速化を進め、ストリーミングMarkdownの処理速度が14倍になりました。TUIにはMarkdownの増分処理を導入しています。pip/Homebrewによるインストールは非推奨となり、「サポート対象外の旧方式」という警告のみを表示します。PyPI/Homebrewへの公開は廃止予定です(PR #57225)。差し替え可能な SecretSource インターフェースを導入し、Bitwardenと1Passwordのプロバイダー、op:// 参照、複数の保管庫、確定的な優先順位、変数ごとの取得元情報に対応しました(PR #59498)。スマート承認がデフォルトになり、フラグが付いたコマンドごとに独立した LLM レビュアーが審査します。YOLOでも有効なユーザー定義の拒否ルールと /deny <reason> を追加しました(PR #62661、#59164、#54518)。プラグインの pre_tool_call から承認を要求するエスカレーションを再導入しました(PR #60504)。ターミナルでの課金管理用に /subscription と /topup、デスクトップに課金タブを追加しています(PR #51639)。サブエージェントの実行記録ファイルをリアルタイムに更新し、バックグラウンドでの委任を永続化しました(PR #67479、#63494)。state.db に配信義務を追跡する台帳を追加し(PR #67181)、委任の同時実行上限を統一するため max_async_children を非推奨にしました(PR #56955)。gatewayではprofileに基づくルーティングと GATEWAY_MULTIPLEX_PROFILES を追加し、ルーティングインデックスを state.db に移行しました。sessions.json は旧方式との互換性を保つ任意のミラーとなります(PR #64835、#65700、#60589、#59203)。プロバイダーとモデル:Fireworks AIを正式にサポートし、選択リストの2番目に配置しました(PR #62593)。DeepInfra、Upstage Solar、GPT-5.6 Sol/Terra/LunaとProの全経路での対応(PR #61616)、grok-4.5の一般提供、kimi-k3(kimi-k2.xは廃止)、Claude Sonnet 5の全面対応、プロバイダーごとの enabled: false と excluded_providers を追加しています(PR #67971)。推論量に max/ultra の段階を追加し、モデルごと・MoAスロットごとの上書き設定と、セッション単位の /reasoning に対応しました(PR #62650、#64458)。CLI/MCP:hermes sessions export でMarkdown/Quarto/HTML/プロンプトのみ/HF-trace形式への出力と --redact に対応しました(PR #60186)。/model --once(PR #67113)、スラッシュコマンドによる複数のskill呼び出しの積み重ね(PR #57987)、--safe-mode、hermes config get/unset(PR #65540)、hermes serve の完全なヘッドレス動作(PR #55923)、MCPの mcp__server__tool 命名方式(PR #52750)を追加しました。リリースの宣伝的な表現は除外しています。対象期間中に取り消された項目(iron-proxyの外向き通信ファイアウォール、dynamic-workflow skill、メモリのprovider-actions)は、提供済みとして記録しない方針です。今回のセッションでの検証日:2026年7月21日。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩

  71. Hermes Agent v0.18.1 リリースタグとv0.18.2 リリースタグ、2026年7月7日〜8日。v0.18系のインフラ修正をまとめたパッチです。v0.18.2の主要な修正では、WhatsApp Baileysのバージョン固定を解除して7.0.0-rc13に更新し、Dockerのビルドの安定性を確保しています。両パッチの対象期間の変更はv0.19.0のリリースノートにまとめられ、すべて記載されています。 ↩

  72. Hermes Agent v0.15.1 リリースノートとHermes Agent v0.15.2 リリースノート。v0.15.1(2026年5月29日01:12 UTC)は、同日公開のVelocityホットフィックスです。ループバックモードでダッシュボードが401エラーによる再読み込みを繰り返す問題を修正しました。Dockerでは HERMES_DASHBOARD_INSECURE=1 の明示的な指定が必須になっています。MCPのパス指定なしのコマンド(npx、npm、node)をDockerコンテナ内で解決できるようにし、Skillsページのソース表示バッジとカテゴリサイドバーを復元しました。KanbanワーカーはSIGTERMに応答するようになり、Skills.shカタログはサイトマップの利用により858件から19,932件に拡大しています。28コミット、21件のPRをマージ、9人の貢献者。v0.15.2(2026年5月29日13:37 UTC)はパッケージングのみを修正したホットフィックスです。wheelとsdistの配布物に plugin.yaml マニフェストを同梱し、ソースを別途読み込まなくてもPyPIからのインストールが動作するようにしました。貢献者は4人です。 ↩

  73. Hermes Agent v0.15.0 リリースノートとHermes Agent リリースページ。「The Velocity release」、タグ v2026.5.28。統計:1,302コミット、747件のPRをマージ、321人のコミュニティ貢献者。run_agent.py をリファクタリングして76%削減しました(16,083行から3,821行へ、14モジュールに分割)。マルチエージェントのKanbanプラットフォームを追加しています(タスクの自動分解、スウォームトポロジー、タスクごとのモデル上書き設定、スケジュール実行タスク、worktree管理)。session_search は再設計によって4,500倍に高速化し、LLMへの依存を解消しました。セキュリティ上の3か所の要所に、Brainworm型のプロンプトインジェクションに対するPromptware防御を導入しています。Bitwarden Secrets Managerとの連携により、プロバイダーごとに必要だった複数のAPIキーを、単一の初期化用トークンで置き換えます。skillバンドルを使うと、1つのスラッシュコマンドで複数のskillを読み込めます。TUIセッションオーケストレーターにより、1つのターミナルウィンドウで複数のセッションを管理できます。画像生成ではKrea 2(Medium/Large)とFALプラグインに対応しました。今回のxAI連携では、ウェブ検索プラグイン、上流のOAuthへの対応、廃止モデルの検出、音声出力における自然なTTSの間を追加しています。GitHubで紹介されているパッチリリースでは、ダッシュボードの401エラーによる再読み込みループ、Dockerの --insecure で環境変数 HERMES_DASHBOARD_INSECURE=1 の明示的な指定を必須にする変更、Docker内でのMCPのパス指定なしのコマンド解決(npx、npm、node)、Skillsページの描画、KanbanワーカーのSIGTERM処理、サイトマップ経由での全19,932件のSkillsカタログへの対応が含まれます。さらに、.md の配信、gatewayのプローブの安全性、ウェブURLの秘匿化、kanban-workerの画像認識機能、hindsightの観測に関するデフォルト設定にも、小規模な修正が加えられています。 ↩↩↩↩

  74. Hermes Agent v0.11.0 リリースノート。2026年4月23日。「The Interface release」では、対話型CLIをReact/Inkで全面的に書き直し、PythonのJSON-RPCバックエンド(tui_gateway)を採用しました。差し替え可能なトランスポートアーキテクチャ(agent/transports/)、Converse API経由のネイティブなAWS Bedrock対応、5つの新しい推論経路(NVIDIA NIM、Arcee AI、Step Plan、Google Gemini CLI OAuth、Vercel ai-gateway)、Codex OAuth経由のGPT-5.5対応を追加しています。17番目のメッセージングプラットフォームとしてQQBotに対応し、QRコードのスキャンで設定できるようになりました。プラグインの拡張ポイントも拡充しています(スラッシュコマンド、ツールのディスパッチ、実行の阻止、結果の変換)。/steer <prompt> では、実行中のエージェントに軌道修正の指示を送れます。次のツール呼び出し後にコンテキストを挿入するため、プロンプトキャッシュを壊しません。Pythonプラグインなしでライフサイクルイベントを処理するシェルフックと、ペイロードをプラットフォームのチャットに直接転送するwebhookの直接配信モードを追加しました。委任機能も改善し、オーケストレーターの役割、設定可能なエージェント生成の深さ、ファイルを介した連携に対応しています。ダッシュボードにはプラグインシステム、即時のテーマ切り替え、i18n、モバイル向けのレスポンシブ対応を追加しました。v0.9.0以降の統計:1,556コミット・761件のPRをマージ・1,314ファイルを変更・224,174行を追加・29人のコミュニティ貢献者。関連情報:Hermes Agent v0.11.0 GitHub リリースタグ。 ↩↩↩

  75. Hermes Agent v0.10.0 リリースノート。2026年4月16日。「Tool Gateway リリース」。Nous Portal の有料サブスクリプション利用者向けに Nous Tool Gateway を統合し、追加の API キーなしで、Firecrawl によるウェブ検索、FAL / FLUX 2 Pro による画像生成、OpenAI TTS、Browser Use によるブラウザー自動化へのマネージドアクセスを提供します。新しい設定フィールド use_gateway で、ツールごとに利用を有効にできます。gateway と直接利用する API キーの両方が設定されている場合、実行時には gateway が優先されます。hermes tools および hermes status と完全に統合されています。非推奨となった環境変数 HERMES_ENABLE_NOUS_MANAGED_TOOLS を置き換えます。実装は @jquesnelle(emozilla)が担当しました。Hermes Agent の CLI は引き続き MIT ライセンスの完全なオープンソースです。gateway は既存の Portal サブスクリプション製品との連携機能であり、CLI の利用を有料に制限するものではありません。サブスクリプションの料金と登録については、Nous Portal もご覧ください。 ↩↩↩