全設定項目索引
設定画面の順序と項目のチェック用索引。実機の日本語 UI と、同一コミットのソース(設定画面定義・日本語ラベル i18n/ja.ts・バックエンド既定値 DEFAULT_CONFIG)を突き合わせて作成している。採取と照合の履歴は バージョンと調査根拠 を参照。
設定画面は 19 画面で構成される。MCP は設定画面になく、「スキルとツール」ページの Connectors タブ(/capabilities?tab=connectors)にある(本ページ末尾の「MCP」を参照)。ナビの並び順は次のとおり(区切り線 3 本を含む)。
- 設定セクション 9 つ(モデル / チャット / 外観 / ワークスペース / 安全性 / Browser / メモリとコンテキスト / 音声 / 詳細)。Browser の直後に「パスワードとログイン」が入る
- 通知 → 請求
- ─ 区切り ─ プロバイダー → ゲートウェイ → キーボードショートカット → ツールとキー → セッション
- ─ 区切り ─ プラグイン
- ─ 区切り ─ 情報
各画面はサイドバーの子項目(サブページ)を持つ。選択中の画面だけ子項目が開き、画面を開くと先頭の子項目が表示される。各ページの上部にはパンくず(「設定 > 画面 > サブページ」)が出て、画面ごとの大見出しは出ない。子項目の一覧は本ページの各見出しの直下に示す。長いラベルはサイドバーで省略表示される(「パスワードとログ…」「メモリとコンテキ…」「キーボードショー…」)。
「Browser」は日本語 UI でもナビラベルが英語のまま(日本語リソース未整備のため英語表示)。プロバイダーの「ローカルモデル」は macOS / Windows / Linux(x64・arm64)では常に表示され、それ以外の環境だけ hermes desktop --local での起動が要る。
表の「画面表示(主)」は実際に見える文字列、「内部キー(サブ)」は設定 API・設定ファイル・.env・デスクトップ保存領域で使う名前。内部キーだけを画面ラベルとして扱わない。ボタンなど永続キーを持たないものは、内部操作名または「操作・保存キーなし」、既定値は「該当なし」と記載する。「未設定(実効: 値)」は、保存値は空だが実行時に括弧内へ解決されることを示す。デバイスローカルの項目で「store/…」と書いたものは、デスクトップの保存モジュール名(config.yaml には入らない)。一部の画面は日本語リソースが未整備で、本文が英語表示のまま(ナビラベルのみ日本語)。該当箇所は行内に明記する。
画面をまたぐ機能
Section titled “画面をまたぐ機能”| 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|
| 検索 ⌘K(設定カード上端のピル) | ⌘K コマンドパレットの設定スコープを開く。設定画面で入力欄の外に文字を打っても開く。全画面の手作りの設定行とサブページそのもの(例: 情報 › アンインストール)が候補に出る | 常時表示 |
| サブページ(サイドバーの子項目)とパンくず | URL の page= で指定。指定が無いときは先頭の子項目へ移る | 先頭の子項目 |
| 適用対象(プロファイルチップ列) | UI 状態 $settingsScopeOverride。この画面の編集をどのプロファイルに書くかを選ぶ。既定以外のプロファイルを編集中は注記「…を編集中」が強調表示される | アクティブプロファイル。プロファイルが 2 つ以上あるときだけ表示 |
| ディープリンク | /settings?tab=<画面>&page=<サブページ>、?setting=<行 ID>(子ページを開いてから該当行へスクロールと強調)、?pview=keys&key=<ENV_KEY>(プロバイダーの API キー)、?tab=plugins&plugin=<id>(各プラグインの設定ページ) | 該当なし |
「適用対象」が出る画面は、モデル / チャット / ワークスペース / 安全性 / Browser / メモリとコンテキスト / 音声 / 詳細 / ツールとキー(いずれも config.yaml 由来)と、プロバイダー(アカウント / API キー / カスタムエンドポイント)、パスワードとログイン、プラグイン。外観・通知・請求・ゲートウェイ・キーボードショートカット・セッション・情報には出ない(端末ローカルまたはマシン単位の設定)。プロバイダーのローカルモデルは常にアクティブプロファイルを対象にする(読み取り専用の注記を表示)。
旧 URL は新しい場所へ転送される。?tab=mcp は「スキルとツール」の Connectors タブ、?tab=connections はゲートウェイ、旧パラメータ aux= / session= / kind=・label=・origin= はそれぞれ補助モデル / セッションのアーカイブ / パスワードとログインの追加ダイアログへ振り分けられる。
01 モデル
Section titled “01 モデル”子項目: メインモデル / 代替モデル / 補助モデル / エージェントの協調
| 子項目 | 画面表示(主) | 内部キー・対象(サブ) | 製品既定値 |
|---|---|---|---|
| メインモデル | プロバイダー | model.provider | 未設定 |
| メインモデル | モデル(「カスタムモデル…」で ID を手入力できる) | model.default | 未設定 |
| メインモデル | 適用 | model.provider + model.default を保存(トースト「Main model updated」は英語表示) | 該当なし |
| メインモデル | 推論レベル(Defaults / Reasoning、英語表示) | agent.reasoning_effort | medium(中) |
| メインモデル | 高速(対応モデルのみ)/ 速度(Speed、英語表示。Ultrafast 対応モデルでは Standard / Fast / Ultrafast のセレクト) | agent.service_tier | 空欄(normal) |
| メインモデル | コンテキストウィンドウの上書き(ラベル位置に説明文の長い一文が表示される) | model_context_length | 0(選択したモデルから検出した値を使う。メインモデルだけを上書きし、補助・MoA には影響しない) |
| メインモデル | バックエンドを再起動 | 読込・保存エラーがコードスキュー(更新後にバックエンドが古いコードのまま)のときだけ表示 | 該当なし |
| 代替モデル | フォールバックモデル(「+ Add fallback」は英語表示) | fallback_providers | 空配列 |
| 補助モデル | 補助モデル(下記 12 タスク) | auxiliary.<タスク>.provider / .model / .reasoning_effort | 全タスク provider: auto, model: ""、推論強度は「継承 · メインモデルの推論強度」 |
| 補助モデル | ビジョン | auxiliary.vision.* | auto / 空欄 |
| 補助モデル | 圧縮 | auxiliary.compression.* | auto / 空欄 |
| 補助モデル | スキルハブ | auxiliary.skills_hub.* | auto / 空欄 |
| 補助モデル | 承認 | auxiliary.approval.* | auto / 空欄 |
| 補助モデル | MCP | auxiliary.mcp.* | auto / 空欄 |
| 補助モデル | タイトル生成 | auxiliary.title_generation.* | auto / 空欄 |
| 補助モデル | レビュー(/review レビューサブエージェント) | auxiliary.review.* | auto / 空欄 |
| 補助モデル | 音声チャット(音声モードの応答) | auxiliary.voice_chat.* | auto / 空欄(推論強度 none) |
| 補助モデル | トリアージ指定(カンバン仕様の具体化) | auxiliary.triage_specifier.* | auto / 空欄 |
| 補助モデル | カンバン分解(タスク分解) | auxiliary.kanban_decomposer.* | auto / 空欄 |
| 補助モデル | プロファイル記述(プロファイル概要の自動生成) | auxiliary.profile_describer.* | auto / 空欄 |
| 補助モデル | キュレーター(スキル使用レビュー) | auxiliary.curator.* | auto / 空欄 |
| 補助モデル | すべてメインにリセット / メインに設定 / 変更 | 操作・保存キーなし | 該当なし |
| 補助モデル | 補助タスクがメインモデル以外で動いている警告と「今後表示しない」 | プロファイル単位で非表示。補助モデルの構成が変わると再び出る | 該当なし |
| エージェントの協調 | エージェント混合(Mixture of Agents)プリセット | moa.default_preset / moa.presets.* | 雛形プリセット default 入り(default_preset: default) |
| エージェントの協調 | 参照モデル・集約モデルの有効化トグル / 参照モデルを追加 / 削除 | moa.presets.*.reference_models[].enabled / moa.presets.*.aggregator.enabled | 有効 |
推論レベルの選択肢は 8 段階: Off(none)/ 最小(minimal)/ 低(low)/ 中(medium)/ 高(high)/ 特高(xhigh)/ 最大(max)/ ウルトラ(ultra)。サブエージェント推論強度(delegation.reasoning_effort、10 詳細)も同じ段階を使う。速度の auto(各ターンの最初の agent.fast_auto_seconds 秒、既定 60)と cold(セッションの最初のターンだけ)は /fast と config.yaml から選ぶ。
補助タスクの一覧の末尾には、プラグインが登録した補助タスクが並ぶ。補助タスクの推論強度は「継承」を選ぶと reasoning_effort を null で保存し、メインモデルの推論強度に従う。config にはこのほか memory_query_rewrite / tts_audio_tags / goal_judge / monitor / background_review の各補助タスク、auxiliary.transient_retries(既定 2)、auxiliary.title_generation.model_upgrade_enabled(既定 オン。オフでモデルを呼ばずに即時の派生タイトルだけを使う)がある。メインモデルの変更がスケジュール済みジョブに影響する場合は「スケジュール済みジョブの確認が必要です」の警告が出る。MoA の参照・集約スロットにはスロット別 reasoning_effort を保存できるが、デスクトップ画面には編集欄がない。
02 チャット
Section titled “02 チャット”子項目: 動作 / 添付ファイル
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| 動作 | 人格 | display.personality | 空欄(なし) |
| 動作 | タイムゾーン | timezone | 空欄(システム) |
| 動作 | 推論ブロック | display.show_reasoning | オン |
| 添付ファイル | Max preview / image load size(英語表示) | store/data-url-read-max(デバイスローカル) | 16 MB(リモートの画像以外の添付は別の上限 256 MB) |
| 添付ファイル | 画像添付 | agent.image_input_mode | auto |
人格候補: なし、Helpful、Concise、Technical、Creative、Teacher、Kawaii、Catgirl、Pirate、Shakespeare、Surfer、Noir、Uwu、Philosopher、Hype。カスタム人格が設定されている場合は追加表示される(config.yaml のルートの personalities も読み、名前を小文字にして重複を除く)。
display 配下には GUI 項目を持たない config 専用キーもある: display.battery(オフ)/ display.show_commentary(オン)/ display.timestamp_format(%H:%M)/ display.status_phrases(空オブジェクト)/ display.busy_steer_ack_enabled(オン)。agent 配下には agent.reasoning_overrides(空オブジェクト。モデル別推論レベルの固定)と agent.local_stream_stale_timeout(900 秒)がある。
子項目: 一般 / テーマ / フォントと表示倍率 / ウィンドウとレイアウト / チャット表示 / ペット
| 子項目 | 画面表示(主) | 内部キー(サブ) | 候補 | 製品初期値 |
|---|---|---|---|---|
| 一般 | 言語 | display.language | English / 简体中文 / 繁體中文 / 日本語 ほか(言語パックのプラグインで追加される) | English |
| 一般 | イントロ表示 | store/intro-splash(デバイスローカル) | オン / オフ | オン |
| 一般 | モデル料金 | store/model-pricing(デバイスローカル) | オン / オフ。オンでモデル選択時に 100 万トークン単価を表示 | オフ |
| 一般 | 起動時に前回のチャットを再開 | display.resume_last_session(プロファイル単位) | オン / オフ | オン |
| 一般 | アプリ内ヒント | store/tips(デバイスローカル) | オン / オフ。「N 件のヒントをもう一度表示」ボタン | オン(初回利用から 30 日で自動的にオフ) |
| 一般 | ガイドツアー | store/tours(デバイスローカル) | オン / オフ | オン(初回利用から 30 日で自動的にオフ) |
| テーマ | カラーモード | localStorage: hermes-desktop-mode-v1 | ライト / ダーク / システム | ライト |
| テーマ | テーマ | localStorage: hermes-desktop-theme-v2 | Nous / GitHub / Catppuccin / Everforest / Solarized / Nous Alt / Classic Hermes / Midnight / Ember / Mono / Slate / Cyberpunk の 12 種(VS Code Marketplace の検索欄付き。検索欄の案内文とテーマ名・説明は英語表示) | Nous |
| フォントと表示倍率 | UI スケール | メインプロセスが保存(Ctrl/Cmd の +/−/0 と連動) | 90 / 100 / 110 / 125 / 150 / 175% | 100% |
| フォントと表示倍率 | チャットの文字サイズ | store/chat-text-scale(デバイスローカル) | 90〜175%。会話と入力欄だけを拡縮 | 110% |
| フォントと表示倍率 | チャットフォント | desktop.font_family | OpenDyslexic / Atkinson Hyperlegible / Lexend / Inter / IBM Plex Sans / Source Sans 3 / Noto Sans / Segoe UI / SF Pro Text、または CSS フォントスタック。「テーマのフォントを使用」ボタンとプレビュー付き | 空欄(テーマのフォント) |
| フォントと表示倍率 | ターミナルフォント | terminal.font_family(プロファイル単位) | インストール済みフォントの候補付き入力。「既定値を使用」「グリフのプレビュー」 | 未設定(実効: 内蔵 JetBrains Mono) |
| ウィンドウとレイアウト | インターフェースモード | store/interface-mode(デバイスローカル) | シンプル / 詳細 | 詳細 |
| ウィンドウとレイアウト | セッションリストの密度 | store/session-list-density(デバイスローカル) | コンパクト / 標準 / 詳細 | コンパクト |
| ウィンドウとレイアウト | タブバー | store/tabstrip-prefs(デバイスローカル) | 自動 / 常に表示 / 表示しない | 自動 |
| ウィンドウとレイアウト | アプリ操作 | store/titlebar-app-actions(デバイスローカル) | 右 / 左(設定・レイアウト・HUD をタイトルバーのどちら側に置くか) | 右 |
| ウィンドウとレイアウト | トレイに最小化 | デバイスローカル。トレイ連携が使える環境だけ表示 | オン / オフ | オフ |
| ウィンドウとレイアウト | ウィンドウの透過 | store/translucency(デバイスローカル) | モード クリア / ガラス。クリアはスライダー 1 本、ガラスは色味 / フェード / くもりの質感(深い / やわらか / 明るい / まぶしい。Windows は 3 段)/ 適用範囲(ウィンドウ全体 / サイドバーのみ)。Linux では非表示 | 0(不透明) |
| ウィンドウとレイアウト | チャット背景 | localStorage: hermes.desktop.backdrop.v1 | オン / オフ | オフ |
| ウィンドウとレイアウト | ファイルブラウザ | store/layout(デバイスローカル。タイトルバーのボタン・⌘J と同じ状態) | オン / オフ。シンプルモードでは「このセッションのみ有効」 | オフ |
| ウィンドウとレイアウト | フローティング入力欄 | store/composer-popout(デバイスローカル) | オン / オフ | オフ(すでに浮かせていた場合はオンのまま) |
| チャット表示 | メッセージの吹き出し | store/user-bubble-transparency(デバイスローカル) | 自分の発言の透過 0〜100% | 0% |
| チャット表示 | テキストの方向 | store/text-direction(デバイスローカル) | 自動 / 右から左 / 左から右 | 自動 |
| チャット表示 | スレッドのタイムラインバーを非表示 | store/thread-timeline(デバイスローカル) | オン / オフ | オフ |
| チャット表示 | メッセージリアクション | store/reactions-enabled(デバイスローカル) | オン / オフ | オフ |
| チャット表示 | バイブハート | store/vibe-hearts-enabled(デバイスローカル) | オン / オフ | オン |
| チャット表示 | ツール呼び出しの表示 | localStorage: hermes.desktop.toolView.technical | プロダクト / テクニカル | プロダクト(false) |
| チャット表示 | コードの差分を非表示 | store/tool-view(デバイスローカル) | オン / オフ | オフ |
| チャット表示 | 思考ブロックをデフォルトで折りたたむ | store/reasoning-disclosure(デバイスローカル) | オン / オフ | オフ |
| チャット表示 | インライン埋め込み | localStorage: hermes.desktop.embed-mode / .embed-allowed | 確認 / 常に / オフ。「許可した N 件のサービスをリセット」 | 確認(ask) |
| ペット | ペットを選ぶ / 散歩 / サイズ / ペットを検索 | display.pet.enabled / .slug / .scale ほか | トグル / スライダー。一覧は petdex ギャラリーから取得 | オフ |
インターフェースモードを「シンプル」にすると、ファイルブラウザ・レビュー・ターミナルのペイン、コードの差分、ステータスバー、ナビのアーティファクトとスケジュール済みジョブが既定で隠れ、推論は折りたたまれる。切り替えはこの画面のほか、タイトルバーのレイアウト編集パレット上部、⌘K、キー割り当て view.toggleSimpleMode(既定 未割り当て)でもできる。シンプルモードで「ツール呼び出しの表示」「思考ブロック」の行には注記が付く。
04 ワークスペース
Section titled “04 ワークスペース”子項目: プロジェクトと検出 / シェル環境 / ファイルと実行
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| プロジェクトと検出 | 作業ディレクトリ | terminal.cwd | . |
| プロジェクトと検出 | リポジトリの自動検出 | desktop.repo_scan_enabled | オン |
| プロジェクトと検出 | リポジトリの検索ルート | desktop.repo_scan_roots | 空配列(ホームディレクトリを検索) |
| プロジェクトと検出 | 除外するリポジトリパス | desktop.repo_scan_exclude_paths | 空配列 |
| シェル環境 | 永続シェル | terminal.persistent_shell | オン |
| シェル環境 | 環境変数の引き継ぎ | terminal.env_passthrough | 空配列 |
| ファイルと実行 | コード実行モード(値は英語表示) | code_execution.mode | project |
| ファイルと実行 | ファイル読み取り上限 | file_read_max_chars | 100000 文字 |
カンマ区切りのリスト入力は、フォーカスを外すか Enter を押した時点で確定する。
05 安全性
Section titled “05 安全性”子項目: 承認 / プライバシーとネットワーク / チェックポイント
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| 承認 | 承認モード | approvals.mode | smart(候補: manual / smart / off) |
| 承認 | 承認タイムアウト | approvals.timeout | 300 秒 |
| 承認 | MCP 再読み込みの確認 | approvals.mcp_reload_confirm | オン |
| 承認 | コマンド許可リスト | command_allowlist | 空配列 |
| プライバシーとネットワーク | 利用統計を収集する | telemetry.shared_metrics.enabled(プロファイル単位。バックエンドの RPC 経由で保存) | オフ |
| プライバシーとネットワーク | 利用統計を Nous と共有する(収集がオンのときだけ操作できる。「集計される内容」リンク付き) | telemetry.shared_metrics.send | オフ |
| プライバシーとネットワーク | シークレットを伏せる | security.redact_secrets | オン |
| プライバシーとネットワーク | プライベート URL を許可 | security.allow_private_urls | オフ |
| チェックポイント | ファイルチェックポイント | checkpoints.enabled | オフ |
smart はフラグされたコマンドを LLM レビュアーが個別に判定する既定モード。approvals.deny(ユーザー定義の拒否ルール、既定 空配列。マッチしたコマンドは --yolo / mode: off でも実行前にブロックされ、サンドボックス内でも効く)はこの画面に項目がなく、config.yaml で編集する。ブラウザー側のプライベート URL 設定(browser.allow_private_urls / browser.auto_local_for_private_urls)は「Browser」画面にある。approvals.single_query_mode / approvals.unattended_mode(各 deny)、security.approval.transport(builtin)/ security.approval.transport_fallback(deny)、security.allow_data_training_tiers_noninteractive(オフ)、security.fake_ip_ranges(fake-ip 方式のプロキシ向けに SSRF 判定から外す範囲)、security.allow_lazy_installs(オプション機能の初回使用時インストール)も config 専用キー。同梱スキャナ tirith の設定(security.tirith_enabled / tirith_path / tirith_timeout / tirith_fail_open)は廃止され、マイグレーションで保存値も取り除かれる(チェック内容は組み込みのルールに置き換え)。
06 Browser
Section titled “06 Browser”子項目: ブラウザープロファイル / ローカル・プライベート URL
ナビラベルは日本語 UI でも英語 Browser(日本語リソース未整備)。子項目名は日本語で表示される。
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| ブラウザープロファイル | Use My Real Browser Profile(ラベル・説明とも英語表示) | browser.use_real_profile | オフ |
| ローカル・プライベート URL | ブラウザーのプライベート URL | browser.allow_private_urls | オフ |
| ローカル・プライベート URL | プライベート URL にはローカルブラウザーを使用 | browser.auto_local_for_private_urls | オン |
browser.use_real_profile は、既定ブラウザ(Chrome / Edge / Brave / Chromium などの Chromium 系のみ)のプロファイルを Hermes 管理のスナップショットへ複製し、同梱 Chromium で使う設定。実プロファイルは直接開かず、オフに戻すとスナップショットは削除される。同じトグルは「スキルとツール」→ ツールセット → Browser の先頭に日本語ラベル「実際のブラウザプロファイルを使用」でも出る(初回オン時は同意ダイアログあり)。browser.real_profile_pin(空欄)/ browser.real_profile_autoclose(オフ)/ browser.backend(空欄)/ browser.snapshot_threshold(15000)/ browser.extension_control.enabled・developer_mode(各オフ)は GUI 項目を持たない config 専用キー。サイトへのログインに使う認証情報は次の「パスワードとログイン」で管理する。
07 パスワードとログイン
Section titled “07 パスワードとログイン”子項目: 保存済みの認証情報 / パスワードマネージャー
ブラウザーを操作するエージェントがサイトへサインインするときに使う認証情報(ログイン・支払いカード・住所)と、外部パスワードマネージャーとの連携を管理する画面。パスワードはこのマシン上で暗号化して保存され、ページへ直接入力されるため、モデルには渡らない。保存先は <HERMES_HOME>/vault/vault.json.enc(プロファイル単位)。全項目が日本語で表示される。
| 子項目 | 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|---|
| 保存済みの認証情報 | 追加 | 追加ダイアログ「ログイン情報・カード・住所を追加」を開く | 該当なし |
| 保存済みの認証情報 | 件数ピル「N 件保存済み」 | 保存件数 | 0 件のときは空状態「まだ何も保存されていません」(事前登録は不要で、初回サインイン時に保存するか尋ねられる) |
| 保存済みの認証情報 | 各行(ラベル・種類・「2FA 自動」・識別子・オリジン・追加日) | ローカル保存分はゴミ箱で削除(確認ダイアログあり、元に戻せない)。外部マネージャー由来の行は削除できずソース名を表示 | 該当なし |
| 追加ダイアログ | 種類 | kind(ログイン / 支払いカード / 住所) | ログイン |
| 追加ダイアログ | ラベル / サイトのオリジン | label / origin(http(s) の URL。種類によらず必須) | 空欄 |
| 追加ダイアログ | 識別子の種類 / 識別子 / パスワード / 認証キー(任意) | identifier_type(メール / 電話番号 / ユーザー名)/ identifier / password / otp_secret(Base32 か otpauth://) | メール / 空欄(ログインのときだけ表示) |
| 追加ダイアログ | カード番号 / カード名義 / 有効期限(月・年)/ CVC / 郵便番号 | card_* | 空欄(支払いカードのときだけ表示) |
| 追加ダイアログ | 住所 1 行目 / 住所 2 行目(任意)/ 市区町村 / 都道府県・地域(任意)/ 郵便番号 / 国 | address_* | 空欄(住所のときだけ表示) |
| パスワードマネージャー | 1Password | vault.onepassword.enabled | オン(CLI を検出したときだけ有効になる) |
| パスワードマネージャー | Bitwarden | vault.bitwarden.enabled | オン(CLI を検出したときだけ有効になる) |
| パスワードマネージャー | 状態ピル | 未検出 / オフ / ロック中 / ロック解除済み | 環境による |
| パスワードマネージャー | ロック解除 / ロック | マスターパスワードを入力して解除。30 分操作が無いか終了すると自動でロック | 該当なし |
1Password・Bitwarden は、それぞれのコマンドラインツールをインストールしてサインインすると自動で検出される。トグルをオフにすると vault.<名前>.enabled: false を書き込み、ロックする。マネージャーの名前(1Password / Bitwarden)は英語のまま表示される。hermes://open/settings?tab=vault&kind=&label=&origin= のディープリンクで、追加ダイアログを内容入り(秘密値は含まない)で開ける。vault.<名前>.account / binary_path / service_account_token_env は config 専用キー。
08 メモリとコンテキスト
Section titled “08 メモリとコンテキスト”子項目: 永続メモリ / コンテキストと圧縮
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| 永続メモリ | 永続メモリ | memory.memory_enabled | オン |
| 永続メモリ | ユーザープロファイル | memory.user_profile_enabled | オン |
| 永続メモリ | メモリ予算 | memory.memory_char_limit | 2200 文字 |
| 永続メモリ | プロファイル予算 | memory.user_char_limit | 1375 文字 |
| 永続メモリ | メモリプロバイダー(説明は英語表示) | memory.provider | 空欄(内蔵のみ) |
| 永続メモリ | 接続(プロバイダー OAuth) | startMemoryProviderOAuth(操作) | プロバイダー選択時のみ表示 |
| コンテキストと圧縮 | コンテキストエンジン(値は英語表示) | context.engine | compressor |
| コンテキストと圧縮 | 自動圧縮 | compression.enabled | オン |
| コンテキストと圧縮 | 圧縮しきい値 | compression.threshold | 0.5 |
| コンテキストと圧縮 | Codex 圧縮の自動引き上げ | compression.codex_gpt55_autoraise | オン(対応する ChatGPT Codex OAuth モデルの圧縮しきい値を 85% に引き上げる) |
| コンテキストと圧縮 | 圧縮目標 | compression.target_ratio | 0.2 |
| コンテキストと圧縮 | 保護する直近メッセージ | compression.protect_last_n | 20 |
| コンテキストと圧縮 | 圧縮モデルのタイムアウト(秒) | auxiliary.compression.timeout | 120 |
メモリプロバイダーの候補は、バックエンドが検出したプロバイダーから作られる。同梱されているのは ByteRover と RetainDB で、Honcho・Supermemory・Hindsight・Mem0・OpenViking・Holographic はプラグインカタログへ移った(既存の利用者は更新時か初回起動時にデータを保ったまま移行される)。カタログから導入したプロバイダーはユーザープラグインとして候補に加わる。プロバイダー固有の設定はスキーマから生成される設定モーダルで編集する。compression.codex_app_server_auto(既定 native)、compression.no_progress_timeout(既定 空 = 内蔵の 60 秒)は GUI 項目を持たない config 専用キー。
子項目: 音声会話 / 音声認識 / 音声合成
3 つの子項目のどれを開いても、先頭に案内行「音声録音ショートカット」が出る。録音のショートカットは「設定 → キーボードショートカット」のキー割り当て(「Start / stop voice conversation」)で設定し、voice.record_key(既定 ctrl+b)は CLI と TUI 専用になった(この画面の入力欄は削除)。
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| 音声会話 | Voice Chat Mode(英語表示) | voice.voice_chat_mode | chained(候補: chained / gpt-live) |
| 音声会話 | GPT-Live Voice(英語表示) | voice.gpt_live.voice | marin(14 種の候補または自由入力) |
| 音声会話 | GPT-Live Persona(英語表示) | voice.gpt_live.instructions | 空欄 |
| 音声会話 | 最大録音時間 | voice.max_recording_seconds | 120 秒 |
| 音声会話 | Client Direct(英語表示・説明なし) | voice.client_direct | オン(リモートクライアントが STT / TTS を直接呼ぶ。オフでゲートウェイ経由) |
| 音声認識 | 音声認識 | stt.enabled | オン |
| 音声認識 | Echo Transcripts(英語表示) | stt.echo_transcripts | オン |
| 音声認識 | 音声認識プロバイダー | stt.provider | 未設定(実効: 自動検出でローカル優先。実機は Local 表示) |
| 音声認識 | Live Transcription(英語表示) | stt.streaming | オフ(話しながら文字起こしを表示。OpenAI / xAI / ElevenLabs) |
| 音声認識 | ローカル文字起こしモデル | stt.local.model | base(候補に turbo を含む) |
| 音声認識 | 文字起こし言語 | stt.local.language | 空欄(自動) |
| 音声認識 | OpenAI STT モデル | stt.openai.model | whisper-1(自由入力可) |
| 音声認識 | OpenAI Live Transcription Model(英語表示) | stt.openai.streaming_model | gpt-live-transcribe |
| 音声認識 | Groq STT モデル | stt.groq.model | 未設定(候補: whisper-large-v3-turbo / whisper-large-v3。自由入力可) |
| 音声認識 | Mistral STT モデル | stt.mistral.model | voxtral-mini-latest(自由入力可) |
| 音声認識 | xAI STT Model(英語表示) | stt.xai.model | 空欄(実効: grok-voice-transcribe-2.0) |
| 音声認識 | DeepInfra STT Model(英語表示) | stt.deepinfra.model | 空欄(実効: ライブカタログの先頭) |
| 音声認識 | ElevenLabs STT モデル | stt.elevenlabs.model_id | scribe_v2 |
| 音声認識 | ElevenLabs 言語 | stt.elevenlabs.language_code | 空欄(自動) |
| 音声認識 | 音声イベントをタグ付け | stt.elevenlabs.tag_audio_events | オフ |
| 音声認識 | 話者分離 | stt.elevenlabs.diarize | オフ |
| 音声合成 | 音声合成プロバイダー(説明は英語表示) | tts.provider | edge |
| 音声合成 | 応答を読み上げる | voice.auto_tts | オフ |
| 音声合成 | Edge 音声 | tts.edge.voice | en-US-AriaNeural |
| 音声合成 | OpenAI TTS モデル | tts.openai.model | gpt-4o-mini-tts |
| 音声合成 | OpenAI 音声 | tts.openai.voice | alloy |
| 音声合成 | ElevenLabs 音声 | tts.elevenlabs.voice_id | pNInz6obpgDQGcFmaJgB |
| 音声合成 | ElevenLabs モデル | tts.elevenlabs.model_id | eleven_multilingual_v2(7 種の候補または自由入力) |
| 音声合成 | xAI (Grok) 音声 | tts.xai.voice_id | eve |
| 音声合成 | xAI 言語 | tts.xai.language | en |
| 音声合成 | 再生速度 | tts.xai.speed | 1.0(0.7〜1.5) |
| 音声合成 | 自動音声タグ | tts.xai.auto_speech_tags | オフ |
| 音声合成 | ストリーミング遅延最適化 | tts.xai.optimize_streaming_latency | 0(0〜2) |
| 音声合成 | サンプルレート | tts.xai.sample_rate | 24000 |
| 音声合成 | ビットレート | tts.xai.bit_rate | 128000 |
| 音声合成 | MiniMax TTS モデル | tts.minimax.model | speech-02-hd |
| 音声合成 | MiniMax 音声 | tts.minimax.voice_id | English_expressive_narrator |
| 音声合成 | Mistral TTS モデル | tts.mistral.model | voxtral-mini-tts-2603 |
| 音声合成 | Mistral 音声 | tts.mistral.voice_id | 音声 UUID |
| 音声合成 | Gemini TTS モデル | tts.gemini.model | gemini-2.5-flash-preview-tts |
| 音声合成 | Gemini 音声 | tts.gemini.voice | Kore |
| 音声合成 | NeuTTS モデル | tts.neutts.model | neuphonic/neutts-air-q4-gguf |
| 音声合成 | NeuTTS デバイス | tts.neutts.device | cpu |
| 音声合成 | KittenTTS モデル | tts.kittentts.model | KittenML/kitten-tts-nano-0.8-int8 |
| 音声合成 | KittenTTS 音声 | tts.kittentts.voice | Jasper |
| 音声合成 | Piper 音声 | tts.piper.voice | en_US-lessac-medium |
| 音声合成 | DeepInfra TTS Model(英語表示) | tts.deepinfra.model | 空欄(カタログ先頭の TTS モデル) |
| 音声合成 | DeepInfra Voice(英語表示) | tts.deepinfra.voice | default |
プロバイダー別の行は、選んだプロバイダーに対応するものだけが表示される。TTS プロバイダーのドロップダウンは edge / elevenlabs / openai / xai / minimax / mistral / gemini / neutts / kittentts / piper の 10 種、STT プロバイダーは local / groq / openai / mistral / xai / elevenlabs / deepinfra の 7 種。config.yaml で定義したカスタム(コマンド型)TTS / STT プロバイダーも候補に加わる。
gpt-live の音声会話は OpenAI の全二重音声モデル gpt-live-1(voice.gpt_live.model)が会話を受け持ち、実際の処理を Hermes に任せる方式で、OpenAI の API キーが要り、音声層に 1 分あたり $0.05 の費用がかかる(画面の英語説明による)。応答のモデルはモデル画面の補助タスク「音声チャット」で選ぶ。OpenAI STT のモデル選択肢には gpt-transcribe が含まれる。OpenAI TTS の音声候補は選択中のモデルに応じて絞り込まれ、tts-1 / tts-1-hd では 9 音声のみ選べる(残り 4 音声は gpt-4o-mini-tts 専用)。voice.submit_mode(既定 direct)、stt.openai.timeout(60)/ stt.openai.max_retries(1)、tts.keep_warm_seconds(60)は GUI 項目を持たない config 専用キー。
子項目: デスクトップと起動 / エージェントの制限 / ツールへのアクセス / ターミナルのバックエンド / サブエージェント / 出力の制限
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| デスクトップと起動 | コンピューターをスリープさせない | 端末ローカル設定(OS のパワーセーブブロッカー) | オフ(候補: オフ / 実行中のみ / 常に) |
| デスクトップと起動 | Disable F12 DevTools(英語表示) | store/disable-f12(デバイスローカル) | オフ |
| デスクトップと起動 | Always open links in external browser(英語表示) | store/external-links(デバイスローカル) | オフ |
| デスクトップと起動 | クイック入力 / クイック入力のショートカット | store/quick-entry(デバイスローカル。対応環境だけ表示) | 有効(⌘ ⇧ Space) |
| デスクトップと起動 | オンボーディングをもう一度実行(ボタン「もう一度実行」) | 現在のモデルで初回セットアップの手順をたどる新しいセットアップチャットを開く | 該当なし |
| デスクトップと起動 | アプリ内更新時のローカル変更(値は英語表示) | updates.non_interactive_local_changes | stash |
| エージェントの制限 | 最大エージェントステップ | agent.max_turns | null(画面では空欄=上限なし。数値を入れると上限になる) |
| エージェントの制限 | API 再試行回数 | agent.api_max_retries | 3 |
| エージェントの制限 | サービス階層(説明は英語表示) | agent.service_tier | 空欄(normal) |
| ツールへのアクセス | 有効なツールセット | toolsets | ["hermes-cli"] |
| ツールへのアクセス | ツール使用の強制 | agent.tool_use_enforcement | auto |
| ターミナルのバックエンド | 実行バックエンド(説明は英語表示) | terminal.backend | local |
| ターミナルのバックエンド | コマンドタイムアウト | terminal.timeout | 180 秒 |
| ターミナルのバックエンド | Docker イメージ(説明は英語表示) | terminal.docker_image | nousresearch/hermes-sandbox:desktop |
| ターミナルのバックエンド | Singularity イメージ(説明は英語表示) | terminal.singularity_image | docker://nousresearch/hermes-sandbox:desktop |
| ターミナルのバックエンド | Modal イメージ(説明は英語表示) | terminal.modal_image | nousresearch/hermes-sandbox:desktop |
| ターミナルのバックエンド | Daytona イメージ(説明は英語表示) | terminal.daytona_image | nousresearch/hermes-sandbox:desktop |
| サブエージェント | サブエージェントモデル | delegation.model | 空欄 |
| サブエージェント | サブエージェントプロバイダー | delegation.provider | 空欄 |
| サブエージェント | サブエージェントターン上限 | delegation.max_iterations | 250 |
| サブエージェント | 並列サブエージェント | delegation.max_concurrent_children | 10 |
| サブエージェント | サブエージェントタイムアウト | delegation.child_timeout_seconds | 0 秒(上限なし。子エージェントごとの任意上限) |
| サブエージェント | サブエージェント推論強度(説明は英語表示) | delegation.reasoning_effort | 空欄(親を継承。候補は 01 モデルと同じ 8 段階) |
| 出力の制限 | ターミナル出力上限 | tool_output.max_bytes | 50000 bytes |
| 出力の制限 | ファイルページ上限 | tool_output.max_lines | 2000 行 |
| 出力の制限 | 行長上限 | tool_output.max_line_length | 2000 文字 |
| 出力の制限 | チェックポイント上限 | checkpoints.max_snapshots | 20 |
コンピューターをスリープさせない設定は、以前オンにしていた場合「常に」へ移行する。実行バックエンドの選択は、ヘルスチェック(到達確認)付きのパネルで行い、セットアップが済んでいないバックエンドを選ぶと確認「それでも {backend} を選択しますか?」が出る(選ぶとセットアップが終わるまでターミナル・ファイルツールが使えない)。「有効なツールセット」を空にする編集は、適用前に確認ダイアログ(英語表示)を挟む。自動保存は差分保存で、画面を開いている間に外部(hermes config set など)で変わった項目を古い値で上書きしない。サンドボックスの既定イメージ nousresearch/hermes-sandbox:desktop は、ボットの画面・Computer Use・ブラウザーをサンドボックス内で動かすための表示スタックを含む。保存済みの旧既定イメージ名はマイグレーションで破棄され、明示的に指定したイメージはそのまま残る。terminal.docker_network(既定 オン)、terminal.vercel_image(vercel/sandbox/universal:latest。旧 terminal.vercel_runtime は非推奨)、agent.fast_auto_seconds(60)、agent.auto_recovery_cycles(5)は config 専用キーで、この画面に項目はない。
子項目: デスクトップ通知 / サウンド
| 子項目 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| デスクトップ通知 | 通知を有効にする(マスタートグル) | OS ネイティブ通知の有効化 | オン |
| デスクトップ通知 | 承認が必要 | approval | オン |
| デスクトップ通知 | 入力が必要 | input | オン |
| デスクトップ通知 | 応答完了 | turnDone | オン |
| デスクトップ通知 | ターン失敗 | turnError | オン |
| デスクトップ通知 | バックグラウンドタスク完了 | backgroundDone | オン |
| デスクトップ通知 | クレジット通知 | credits | オン |
| デスクトップ通知 | プラグイン通知 | plugin | オン |
| デスクトップ通知 | テスト通知を送信 | テスト通知の送信(注記「完了通知は Hermes がバックグラウンドにあるときのみ表示されます。」) | 該当なし |
| サウンド | 完了サウンド / 試聴 | 通知サウンドの選択(サウンド名は英語表示) | ─ |
設定は端末ごとに保存される。対象 OS は macOS / Windows。
子項目: 概要 / プラン(プランは請求状態が通常で、プラン変更の操作があるときだけ)
Nous Portal のサブスクリプションとクレジット残高をアプリ内で確認・操作する画面。ナビラベルと子項目名(請求 / 概要 / プラン)は日本語だが、画面本文は英語表示(日本語リソース未整備)。TUI / CLI の /subscription /topup と同じ課金 API を使う。
| 子項目 | 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|---|
| 概要 | 通知カード(例: No payment method on file + Add card ↗) | 課金状態に応じた案内。外部リンクとアプリ内操作の 2 種 | 状態による |
| 概要 | Balance / Plan / Auto-refill(サマリーカード) | 課金 API の現在値表示 | 未接続時は空表示 |
| 概要 | Plan(セクション)+ Change plan / View plans | プランの表示・変更 | 現在のプラン、または未加入 |
| 概要 | Payment & credits(セクション) | Add payment method / Buy credits now(定額ボタンと金額入力)/ Refill when low(Manage) | カード未登録時は購入不可 |
| 概要 | Usage(セクション) | Subscription credits / Top-up credits(Does not expire)/ Monthly spend cap | ─ |
| 概要 | Sign in(未サインイン時) | アプリ内で Nous アカウントにサインインする(説明「Sign in with your Nous account to see your balance, plan and usage here.」) | 未サインイン時のみ表示 |
| 概要 | 無料枠の表示(You’re on the Nous free tier + Sign in) | 無料枠のアカウント。Plan は Free tier、Model は nous/welcome、Connectors は Included | 無料枠利用時のみ表示 |
| プラン | Plans(プランのカード一覧)/ Current plan / Choose ↗ | プラン比較と変更。下位プランへの変更時はダウングレード確認ダイアログ | 該当なし |
設定ファイルに保存されるキーはない(課金状態は Nous Portal 側で管理される)。請求書のセクションは機能フラグで無効のまま表示されない。
13 プロバイダー
Section titled “13 プロバイダー”子項目: アカウント / API キー / カスタムエンドポイント / ローカルモデル(macOS / Windows / Linux の x64・arm64 では常に表示。それ以外は --local 起動時のみ)
アカウント / API キー / カスタムエンドポイントの先頭には「適用対象」のプロファイル選択が出る(プロファイルが 2 つ以上あるとき)。
アカウントと API キーの一覧は、統合プロバイダーカタログ(hermes_cli/provider_catalog.py)から生成される。アカウント画面は初回オンボーディングと同型のピッカーで、見出し「アカウントを接続」と右上の「API キーをお持ちですか?」、固定行「モデルをローカルで実行」(ローカルモデルの子項目へ移る)が並ぶ。接続済みのアカウントは「接続済み」区分にまとまり、未接続の候補は「別のプロバイダーを接続」(接続済みが無いときは「その他のプロバイダー」)で展開する。Nous の無料枠は接続済みとして扱わず、推奨行に残る。CLI が管理する外部プロバイダーの行は、クリックするとターミナルで切断コマンドを実行する(注記は英語表示)。Base URL・別名キー・英語ラベルの詳細は プロバイダー を正とする。
| 画面表示(主) | プロバイダー ID(サブ) | 製品初期状態 |
|---|---|---|
| Nous Portal | nous | 未接続(「推奨」バッジ) |
| モデルをローカルで実行 | ローカルモデルの子項目へ移る固定行 | 該当なし |
| OpenAI OAuth (ChatGPT) | openai-codex | 未接続 |
| MiniMax | minimax-oauth | 未接続 |
| Qwen Code | qwen-oauth | 未接続 |
| xAI Grok | xai-oauth | 未接続 |
| Anthropic API Key | anthropic | 未接続 |
| Anthropic OAuth: Required Extra Usage Credits to Use Subscription | claude-code | 未接続 |
| GitHub Copilot (ACP) | copilot-acp | 未接続 |
| Fireworks AI / OpenRouter | fireworks / openrouter(API キー側へ誘導する固定行) | 未接続(候補を展開したときだけ表示) |
Google Vertex AI(vertex)はカタログ上のプロバイダーで、アカウント一覧にはカード表示されない(利用は CLI・設定ファイルから)。
API キー
Section titled “API キー”主キーのみ記載。展開時の Base URL・設定済み時だけ残る別名キーは プロバイダー(API キー) を参照。一覧の先頭に「ローカル / カスタムエンドポイント」の導線行と検索欄(「プロバイダーを検索…」)があり、各行の右に「<名前> キーを貼り付け」の入力欄が並ぶ。
| 順 | 画面表示(主) | 内部キー(サブ・主キー) | 製品既定値 |
|---|---|---|---|
| 1 | Fireworks AI | FIREWORKS_API_KEY | 未設定 |
| 2 | OpenRouter | OPENROUTER_API_KEY | 未設定 |
| 3 | Anthropic | ANTHROPIC_API_KEY | 未設定 |
| 4 | xAI | XAI_API_KEY | 未設定 |
| 5 | DeepSeek | DEEPSEEK_API_KEY | 未設定 |
| 6 | MiniMax | MINIMAX_API_KEY | 未設定 |
| 7 | MiniMax (China) | MINIMAX_CN_API_KEY | 未設定 |
| 8 | OpenCode Zen | OPENCODE_ZEN_API_KEY | 未設定 |
| 9 | OpenCode Go | OPENCODE_GO_API_KEY | 未設定 |
| 10 | NVIDIA NIM | NVIDIA_API_KEY | 未設定 |
| 11 | Ollama Cloud | OLLAMA_API_KEY | 未設定 |
| 12 | LM Studio | LM_API_KEY | 未設定 |
| 13 | Xiaomi MiMo | XIAOMI_API_KEY | 未設定 |
| 14 | Arcee AI | ARCEEAI_API_KEY | 未設定 |
| 15 | GMI Cloud | GMI_API_KEY | 未設定 |
| 16 | Azure Foundry | AZURE_FOUNDRY_API_KEY | 未設定 |
| 17 | Alibaba Cloud (Coding Plan) | ALIBABA_CODING_PLAN_API_KEY | 未設定 |
| 18 | GitHub Copilot | COPILOT_GITHUB_TOKEN | 未設定 |
| 19 | Google AI Studio | GOOGLE_API_KEY | 未設定 |
| 20 | HuggingFace | HF_TOKEN | 未設定 |
| 21 | Kilo Code | KILOCODE_API_KEY | 未設定 |
| 22 | Kimi / Kimi Coding Plan | KIMI_API_KEY | 未設定 |
| 23 | Kimi / Moonshot (China) | KIMI_CN_API_KEY | 未設定 |
| 24 | NovitaAI | NOVITA_API_KEY | 未設定 |
| 25 | OpenAI API | OPENAI_API_KEY | 未設定 |
| 26 | Qwen Cloud | DASHSCOPE_API_KEY | 未設定 |
| 27 | StepFun Step Plan | STEPFUN_API_KEY | 未設定 |
| 28 | Tencent TokenHub | TOKENHUB_API_KEY | 未設定 |
| 29 | Z.AI (GLM) | GLM_API_KEY | 未設定 |
先頭 12 件の並びは実機で確認済み。実機の一覧には上表のほか Nebius Token Factory・Ramp Router・Tencent TokenPlan・Upstage Solar・Vercel AI Gateway なども並ぶが、全体の順序と総数は採取していない。同じ環境変数を使う複数のプロバイダー(例: DASHSCOPE_API_KEY)は、プロバイダーごとに別のカードとして展開される。?pview=keys&key=<ENV_KEY> のディープリンクで、絞り込みを解除して該当カードを展開する。
カスタムエンドポイント
Section titled “カスタムエンドポイント”OpenAI 互換のカスタムエンドポイント(ローカル LLM サーバー・プロキシ等)を登録してメインモデルに使う画面。ナビラベルは「カスタムエンドポイント」(日本語)、画面本文は英語表示。保存先は config.yaml の providers.<ID> エントリ(既存の手書きキーはマージ保持される)。
| 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|
| 保存済みエンドポイントの一覧(件数ピル) | providers.<id>(config.yaml) | 0 件 |
| Use | 該当エンドポイントをメインモデルに切り替え | 該当なし |
| 削除 | providers.<id> を削除(config.yaml 直書き分は削除不可) | 該当なし |
| Add Endpoint / Edit Endpoint(フォーム見出し) | UI 状態 | Add Endpoint |
| Name | 表示名 | 空欄 |
| Provider ID | providers のキー名 | 空欄 |
| Endpoint URL | providers.<id>.base_url | 空欄 |
| API Mode | providers.<id>.api_mode(Auto-detect / Chat Completions / Responses API / Anthropic Messages) | Auto-detect |
| Default Model | providers.<id>.model(候補付きの入力欄) | 空欄 |
| Context | providers.<id>.context_length | 空欄(Auto) |
| API Key | providers.<id>.api_key(空欄なら現在のキーを維持) | 空欄(任意) |
| Use for new chats | 保存時にメインモデルへ設定 | オン |
| Discover models | /models からモデル一覧を取得 | オン |
| Test | エンドポイント到達確認。成功時は実際に /models を返した URL でエンドポイント URL を自動補正する | 該当なし |
| Save / New endpoint | フォーム内容を保存 / 新規入力 | 該当なし |
ローカルモデル
Section titled “ローカルモデル”macOS / Windows / Linux(x64・arm64)では常に表示される子項目。それ以外の環境では hermes desktop --local で起動したときだけ表示される。セットアップ前は推奨モデルを示すクイックスタート(説明と「Set up for me」は英語表示、「自分で選ぶ」は日本語)が出る。上から プロファイルの注記 → ローカルランタイム → このマシン → モデル → Hugging Face 参照 の順に並ぶ。
| 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|
| ローカルランタイム(インストール / 更新 / オン・オフ / 状態) | local_runtime.enabled / local_runtime.backend(llama.cpp。ビルドはパッケージマネージャーのロックで管理) | オフ / auto |
| このマシン(GPU メモリ・RAM・ユニファイドメモリ) | ハードウェア判定の表示 | 該当なし |
| モデル(おすすめ / ダウンロード / 一時停止・再開 / 使用する / 読み込み・アンロード / 配置・適合バッジ) | local_runtime.models_max | 4 |
| このマシン向けの自動推奨モデルはありません / モデルを探す | 推奨できるモデルが無いときの表示 | 該当なし |
| さらにモデルを探す(Hugging Face 検索・GGUF の手動追加) | 操作・保存キーなし | 該当なし |
| ポート | local_runtime.port / local_runtime.detect_ports | 0(自動)/ 空配列 |
推奨モデルには、GPU メモリに収まるものだけが選ばれる。ローカルモデルは常にアクティブなプロファイルを対象にする。
14 ゲートウェイ
Section titled “14 ゲートウェイ”子項目: このウィンドウ / 保存済みの接続 / リモート更新
| 子項目 | 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|---|
| このウィンドウ | Connection mode(英語表示の見出し) | 接続モードの選択 | ─ |
| このウィンドウ | env オーバーライド | HERMES_DESKTOP_REMOTE_URL(token 時は HERMES_DESKTOP_REMOTE_TOKEN)。設定時は URL 入力だけ無効になり、サインイン・サインアウトはできる(保存とテストは無効) | 未設定(envOverride: false) |
| このウィンドウ | ローカルゲートウェイ | connection.json の mode: local | mode: local |
| このウィンドウ | Hermes Cloud(説明は英語表示) | mode: cloud(サインインしてアカウントのエージェントを選択。URL 入力不要) | 未選択 |
| このウィンドウ | Saved Cloud gateways / Use gateway / Active in this window(英語表示) | 保存済みの Cloud ゲートウェイの一覧と切り替え | 該当なし |
| このウィンドウ | リモートゲートウェイ | mode: remote | 未選択 |
| このウィンドウ | SSH で接続 | mode: ssh(user@host または ~/.ssh/config の Host エイリアス。ホスト鍵は初回信頼で固定) | 未選択 |
| このウィンドウ | リモート URL | remote.url | 空欄 |
| このウィンドウ | 認証 | remote.authMode(URL の調査結果で自動判定。サインイン / パスワード / トークン) | token |
| このウィンドウ | セッショントークン | remote.token | 未設定 |
| このウィンドウ | トークンは平文で保存されています(警告バナー) | remoteTokenPlainText(セキュアストレージが無い環境で平文保存に同意したとき) | 非表示 |
| このウィンドウ | リモートをテスト | testConnectionConfig(...)(接続確認に失敗した状態でも押せる) | 該当なし |
| このウィンドウ | 次回起動時のために保存 | saveConnectionConfig(...)(平文保存になる場合は確認ダイアログ「平文で保存」) | 該当なし |
| このウィンドウ | 保存して再接続 | applyConnectionConfig(...) | 該当なし |
| このウィンドウ | サインアウト | oauthLogoutConnectionConfig(...) | 該当なし |
| このウィンドウ | OS キーチェーンで保存済みのシークレットを暗号化 | setSecretStorageEncryption(Keychain Access / GNOME Keyring または KWallet / Windows DPAPI) | オフ |
| このウィンドウ | 診断 / ログを開く | revealLogs() | 該当なし |
| 保存済みの接続 | 登録済み接続の一覧(見出しは出ず、英語の説明文から始まる) | This device / Remote gateway / Hermes Cloud / SSH。ピル Current / Primary / App-managed | This device のみ |
| 保存済みの接続 | Add connection / 編集 / 削除 / Make primary / Test(英語表示) | 接続の追加・編集・削除・プライマリ設定・疎通テスト | 該当なし |
| 保存済みの接続 | 認証方式(Session token / サインイン) | URL・認証方式・トークン・サインインは「このウィンドウ」と共通の入力部品 | URL の調査結果による |
| 保存済みの接続 | リモート Hermes パス(任意、SSH のみ) | リモートの hermes バイナリへのフルパス。空欄で自動検出 | 空欄 |
| 保存済みの接続 | Extra gateway headers(英語表示) | 追加ヘッダー(Cloudflare Access 等)。値は暗号化保存 | 空欄 |
| 保存済みの接続 | Update all instances(英語表示) | 登録済み全インスタンスの一括更新(Hermes Cloud 管理分と macOS の SSH 接続はスキップ) | 該当なし |
| 保存済みの接続 | At startup, return to Sessions on the last-used gateway(英語表示) | 起動時に最後に使ったゲートウェイのセッションへ戻る。オフでプライマリを開く | オフ |
| リモート更新 | Managed updates(英語表示の見出し)と接続ごとの Update | SSH 種別の接続ごとの更新管理 | SSH 接続が無いときは空状態(説明は日本語) |
接続モードは ローカル / Hermes Cloud / リモート / SSH の 4 択。接続設定はマシン単位で、プロファイル別の「適用対象」は出ない(プロファイルは接続先ゲートウェイから検出される)。SSH のユーザー名・鍵パスは空欄にして保存すると消去できる。Tailscale SSH で対話的なブラウザー確認が要る場合は、ターミナルで ssh <host> true を実行して確認を済ませてから再試行する(エラー文は日本語)。「保存済みの接続」「リモート更新」の本文は日本語リソースが無く、英語表示。
15 キーボードショートカット
Section titled “15 キーボードショートカット”子項目: キー割り当て / HUDジェスチャー / 画面キャプチャ
デスクトップアプリのショートカットを検索・再割り当てする画面。ナビラベルと子項目名は日本語だが、キー割り当ての本文(説明・検索欄・カテゴリ・アクション名)は英語表示。変更分だけが localStorage: hermes.desktop.keybinds に保存される(既定値との差分保存)。
| 子項目 | 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|---|
| キー割り当て | 説明「Click a shortcut to rebind it · ⌘/ reopens this panel.」 | 操作・保存キーなし | 該当なし |
| キー割り当て | Search shortcuts…(検索欄) | ラベル・ID でのフィルタ | 空欄 |
| キー割り当て | カテゴリ見出し | COMPOSER / PROFILES / SESSION / NAVIGATION / VIEW ほか | 全カテゴリ展開 |
| キー割り当て | 各アクション行 | localStorage: hermes.desktop.keybinds。未割り当ての行は「set」と表示 | 既定コンボ表示 |
| キー割り当て | Rebind | キー入力待ち(Press a key…)にして再割り当て | 該当なし |
| キー割り当て | Clear | 既定のまま割り当てがある行にホバーで出る × で割り当てを外す | 該当なし |
| キー割り当て | Reset to default / Reset all | 該当アクション / 全アクションを既定に戻す | 該当なし |
| キー割り当て | 変更不可の行 | 読み取り専用ショートカット(Focus composer ⌘L、Move HUD to pointer ⌘⇧G など 15 件) | 固定表示 |
| HUDジェスチャー | キーをタップして HUD を呼び出す | デバイスローカル。Mac は ⌘ + Option、Windows / Linux は Ctrl + Alt を押して離すと HUD を前面に表示(入力監視の許可が必要。Linux は X11 のみ、Wayland は非対応) | オフ |
| 画面キャプチャ | スクリーンショットのショートカット | Mac 単位。左右の Command キーを同時に押すと最前面のウインドウを撮影して下書きに添付(自動送信はしない。入力監視と画面収録の許可が必要) | オフ |
既定マップの正本は apps/desktop/src/lib/keybinds/actions.ts(定義 71 件)。主な既定: session.new は ⌘N、session.next / session.prev は Ctrl+Tab / Ctrl+Shift+Tab と Ctrl+PageDown / PageUp、view.tabSlot.1〜9(Switch to tab N)は ⌘1〜⌘9(タブ帯があればタブ、無ければプロファイルの切り替えに使う)、conversation.scrollPageUp / Down は PageUp / PageDown、view.toggleTabStrip(Toggle tabs)は ⌘⌥T、view.showBrowser(Toggle browser)は ⌘⇧L、composer.voice(Start / stop voice conversation)は macOS が Ctrl+B・Windows / Linux が Ctrl+Alt+V、view.selectionToComposer(Send selection to composer)は ⌘L。composer.dictate(Start / stop dictation)、composer.reasoningUp / Down(Reasoning level up / down)、view.cycleSidebarGrouping、view.toggleProfileRail、view.toggleSimpleMode、session.archive は既定なし。nav.skills は nav.capabilities(ラベルは Open skills のまま)に改名された。プラグインが登録したアクション(例: 「カンバン: 新しいタスク」⌘⌥N)は日本語で表示される。
16 ツールとキー
Section titled “16 ツールとキー”子項目: ツール / 設定
| 順 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| 1 | AGENT BROWSER ENGINE | AGENT_BROWSER_ENGINE | 未設定(実効: auto) |
| 2 | BRAVE SEARCH | BRAVE_SEARCH_API_KEY | 未設定 |
| 3 | BROWSER USE | BROWSER_USE_API_KEY | 未設定 |
| 4 | BROWSERBASE | BROWSERBASE_API_KEY | 未設定 |
| 5 | BROWSERBASE PROJECT ID | BROWSERBASE_PROJECT_ID | 未設定 |
| 6 | BRV | BRV_API_KEY | 未設定 |
| 7 | CAMOFOX | CAMOFOX_API_KEY | 未設定 |
| 8 | CAMOFOX URL | CAMOFOX_URL | 未設定 |
| 9 | CONNECTOR GATEWAY URL | CONNECTOR_GATEWAY_URL | 未設定(実効: ドメインから導出) |
| 10 | ELEVENLABS | ELEVENLABS_API_KEY | 未設定 |
| 11 | EXA | EXA_API_KEY | 未設定 |
| 12 | FAL | FAL_KEY | 未設定 |
| 13 | FIRECRAWL | FIRECRAWL_API_KEY | 未設定 |
| 14 | FIRECRAWL API URL | FIRECRAWL_API_URL | 未設定 |
| 15 | FIRECRAWL BROWSER TTL | FIRECRAWL_BROWSER_TTL | 未設定(実効: 300 秒) |
| 16 | FIRECRAWL GATEWAY URL | FIRECRAWL_GATEWAY_URL | 未設定 |
| 17 | GITHUB | GITHUB_TOKEN | 未設定 |
| 18 | HINDSIGHT | HINDSIGHT_API_KEY | 未設定 |
| 19 | HINDSIGHT API URL | HINDSIGHT_API_URL | 未設定(実効: https://api.hindsight.vectorize.io) |
| 20 | HONCHO | HONCHO_API_KEY | 未設定 |
| 21 | HONCHO BASE URL | HONCHO_BASE_URL | 未設定 |
| 22 | KEENABLE | KEENABLE_API_KEY | 未設定(キー無しの無料枠でも動作) |
| 23 | KREA | KREA_API_KEY | 未設定 |
| 24 | MEM0 | MEM0_API_KEY | 未設定 |
| 25 | MISTRAL | MISTRAL_API_KEY | 未設定 |
| 26 | OPENVIKING | OPENVIKING_API_KEY | 未設定(ローカル開発モードでは空欄可) |
| 27 | OPENVIKING ENDPOINT | OPENVIKING_ENDPOINT | 未設定(実効: http://127.0.0.1:1933) |
| 28 | PARALLEL | PARALLEL_API_KEY | 未設定 |
| 29 | PERPLEXITY | PERPLEXITY_API_KEY | 未設定 |
| 30 | PORCUPINE ACCESS | PORCUPINE_ACCESS_KEY | 未設定 |
| 31 | RETAINDB | RETAINDB_API_KEY | 未設定 |
| 32 | RETAINDB BASE URL | RETAINDB_BASE_URL | 未設定(実効: https://api.retaindb.com) |
| 33 | SEARXNG URL | SEARXNG_URL | 未設定 |
| 34 | SUPERMEMORY | SUPERMEMORY_API_KEY | 未設定 |
| 35 | TAVILY | TAVILY_API_KEY | 未設定 |
| 36 | TOOL GATEWAY DOMAIN | TOOL_GATEWAY_DOMAIN | 未設定(実効: nousresearch.com) |
| 37 | TOOL GATEWAY SCHEME | TOOL_GATEWAY_SCHEME | 未設定(実効: https) |
| 38 | TOOL GATEWAY URL | TOOL_GATEWAY_URL | 未設定(実効: ドメインから導出) |
| 39 | TOOL GATEWAY USER | TOOL_GATEWAY_USER_TOKEN | 未設定 |
| 40 | VOICE TOOLS OPENAI | VOICE_TOOLS_OPENAI_KEY | 未設定 |
一覧はバックエンドの環境変数カタログ(OPTIONAL_ENV_VARS のカテゴリ tool)から生成され、アルファベット順に並ぶ。上表の 40 行はカタログ定義から確定した(実機スクリーンショットでは先頭と末尾の並びを確認)。前回から HERMES_LANGFUSE_BASE_URL / HERMES_LANGFUSE_PUBLIC_KEY / HERMES_LANGFUSE_SECRET_KEY の 3 行が外れ(Langfuse は公式プラグインへ移行)、CONNECTOR_GATEWAY_URL / PERPLEXITY_API_KEY / TOOL_GATEWAY_URL の 3 行が加わった。画面側は内部キー末尾の _API_KEY / _TOKEN / _KEY を省いて表示する。.env に手書きした未知のキーは「custom」として別枠で一覧に加わる。
| 順 | 画面表示(主) | 内部キー(サブ) | 製品既定値 |
|---|---|---|---|
| 1 | GATEWAY ALLOW ALL USERS | GATEWAY_ALLOW_ALL_USERS | 未設定(実効: false) |
| 2 | GATEWAY PROXY | GATEWAY_PROXY_KEY | 未設定 |
| 3 | GATEWAY PROXY URL | GATEWAY_PROXY_URL | 未設定 |
| 4 | HERMES EPHEMERAL SYSTEM PROMPT | HERMES_EPHEMERAL_SYSTEM_PROMPT | 未設定 |
| 5 | HERMES PREFILL MESSAGES FILE | HERMES_PREFILL_MESSAGES_FILE | 未設定 |
| 6 | SUDO PASSWORD | SUDO_PASSWORD | 未設定 |
「設定」には、上表のカテゴリ setting の 3 件とゲートウェイ共通の 3 件(GATEWAY_*)に加えて、メッセージングプラットフォームごとのチャネル・許可設定の変数(MATRIX / MATTERMOST / NTFY / PHOTON / QQ / QQBOT / SIMPLEX / TEAMS / TELEGRAM / WECOM / WHATSAPP 系の * ALLOW ALL USERS / * HOME CHANNEL / * HOME CHANNEL NAME / * REQUIRE MENTION / * REPLY MODE / * FREE RESPONSE ROOMS / * FREE RESPONSE CHANNELS / MATRIX DM AUTO THREAD など。右列はすべて「省略可能」)が並ぶ。総件数と先頭の行は未確認。ツール進捗は config.yaml の display.tool_progress で管理する。
17 セッション
Section titled “17 セッション”子項目: アーカイブと保持 / 既定のプロジェクトフォルダー
旧「アーカイブ済みチャット」から改名された画面。
| 子項目 | 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|---|
| アーカイブと保持 | 古いチャットを自動アーカイブ | sessions.auto_archive / sessions.auto_archive_days | オフ / 3(ピン留めしたチャットは対象外) |
| アーカイブと保持 | アーカイブ済みセッション(件数ピル) | 一覧条件 archived=only。全件を取得する | 0件 |
| アーカイブと保持 | アーカイブを解除 | 対象セッションの archived: false | 該当なし |
| アーカイブと保持 | 完全に削除(ゴミ箱アイコン) | 対象 session.id を削除(アプリ内の確認ダイアログ「完全に削除」。未読状態と進行中ターンのローカル記録も破棄) | 該当なし |
| アーカイブと保持 | アーカイブがありません / アーカイブ済みセッションを読み込めませんでした | 一覧が空 / 一覧 API エラー | 状態による |
| 既定のプロジェクトフォルダー | 既定のプロジェクトフォルダー(未設定の場合はホームディレクトリ) | userData/project-dir.json の dir | 未設定 |
| 既定のプロジェクトフォルダー | 選択 / 変更 / クリア | pickDefaultProjectDir() / setDefaultProjectDir(<path>) / setDefaultProjectDir(null) | 該当なし |
サイドバーのチャットを Alt / ⌥ + Shift クリックするとアーカイブできる。sessions.auto_prune(既定 オン)は GUI 項目を持たない config 専用キーで、90 日間操作の無い終了済みセッションを起動時に自動削除する(ピン留め・開いているセッションは対象外。残したい場合は false にする)。sessions.show_subagents(既定 オフ。サイドバーにサブエージェントの実行を入れ子で表示するか)も config 専用。
18 プラグイン
Section titled “18 プラグイン”子項目: 設定ページを持つプラグインごとの子項目(そのプラグインのサブページは孫項目)。設定を持つプラグインが無いときは子項目が無い。
インストール済みプラグインが追加する設定ページの入口。プラグインの一覧・有効化・インストール・アンインストールはこの画面ではなく、「スキルとツール」の Plugins タブ(/capabilities?tab=plugins)で行う → スキルとツール
| 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|
| プラグインを管理 → | 「スキルとツール」の Plugins タブへ移る | 該当なし |
| 適用対象(プロファイル選択) | エージェントプラグインの設定を書き込むプロファイル | アクティブプロファイル。プロファイルが 2 つ以上あるときだけ表示 |
| 説明「インストール済みプラグインが追加するオプションです。…」 | 操作・保存キーなし | 該当なし |
| 設定を持つプラグインの一覧(アイコン・名前・「N ページ」) | デスクトッププラグインが登録した設定ページと、エージェントプラグインの config_schema から自動生成される「エージェント設定」ページ | 0 件のときは「設定を持つプラグインはまだありません。」 |
| 自動生成フォーム(真偽値 / 選択 / JSON / 数値 / 秘密値 / 文字列) | 秘密値以外は plugins.manage で保存。秘密値はプロファイルの .env に書き、config.yaml には書かない(ボタン・状態表示は英語) | 空欄なら現在値を維持 |
?tab=plugins&plugin=<key>&ppage=<サブページ> / ?tab=plugins&agent=<key>(&profile= を付けるとそのプロファイルを対象にする)でプラグインの設定ページを直接開ける。設定ページの無いプラグインを指定すると「このプラグインには設定ページがありません。無効化またはアンインストールされた可能性があります。」と表示される。plugins.isolation(既定 in_process)/ plugins.auto_update_check_hours(24)/ plugins.auto_apply(オフ)/ plugins.clone_timeout(300)/ plugins.load_timeout(10)は config 専用キー。
子項目: バージョンと更新 / アンインストール
| 子項目 | 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|---|
| バージョンと更新 | Hermes / バージョン(横にチャンネル名「安定版」/「先行版」) | DesktopVersionInfo.appVersion | 固定値ではない |
| バージョンと更新 | 更新(カード。例「最新の安定版リリース(vX.Y.Z)を使用しています。」「前回確認」) | DesktopUpdateStatus | status: null |
| バージョンと更新 | 今すぐ確認 / 今すぐ更新 / リリースノート | IPC hermes:updates:check / startActiveUpdate() / RELEASE_NOTES_URL | 更新がある場合のみ「今すぐ更新」 |
| バージョンと更新 | アップデートチャンネル(安定版リリース / すべてのコミット) | config.yaml の update.installs.<sha16>.channel。CLI は hermes update --set-channel <名前>。ソースインストールでだけ表示(パッケージ版では出ない) | 公式チェックアウトは安定版、fork・ミラーは main |
| バージョンと更新 | 安定版リリース X に戻す | 安定版より新しいビルドを使っているときのロールバック(確認とバックアップ案内あり) | 該当時のみ |
| バージョンと更新 | 詳細表 Version / Commit / チャンネル / Build Origin / Distribution / Install ID | 実行状態の表示(チャンネル以外のラベルは英語表示) | 固定値ではない |
| バージョンと更新 | アプリのビルドが古くなっています(バナー)/ インストーラーを入手 | version.bundleOutOfSync(ランタイムだけ更新されデスクトップのビルドが古いとき) | 非表示 |
| バージョンと更新 | 再起動して更新を完了(バナー)/ Hermes を再起動 | version.bundleSwapPending | 非表示 |
| バージョンと更新 | このHermesビルドはサポートされていません | サポート切れビルドの警告 | 非表示 |
| バージョンと更新 | リモートバックエンドの更新カード | リモート接続時にバックエンド側の更新を表示(リリースノートのリンクなし) | リモート接続時のみ |
| アンインストール | Hermes をアンインストール(赤枠のカード) | UninstallSection。「Chat GUI のみアンインストール」/「GUI とエージェントをアンインストール、データは保持」/「すべてアンインストール」から選び、「はい、アンインストール」で実行 | 該当なし |
| アンインストール | OS 管理のインストールの案内(英語表示) | OS・パッケージマネージャーが管理するインストールでは削除の選択肢を出さず、OS の手順とデータの保存場所を示す(Windows は Open Apps settings) | 該当時のみ |
旧「自動更新」行(ブランチとコミットの表示)は無くなった。更新の確認は 1 日 1 回の GitHub API 呼び出しになった(リリースノートによる)。updates.check(既定 オン)は config 専用キー。?setting=updates で更新欄へ直接移れる。
MCP(設定画面外)
Section titled “MCP(設定画面外)”MCP は設定画面ではなく、「スキルとツール」ページ(/capabilities)の Connectors タブにある。Connectors タブでは、Nous のツールゲートウェイ経由のホスト型アプリ(Linear・Notion など)とローカルの MCP サーバーが 1 つの一覧に並ぶ(本文は英語表示。フィルタは All / On this device / Available)。旧 URL /settings?tab=mcp へのディープリンクは Connectors タブへ自動で転送される(server= パラメータも引き継がれる)。
| 画面表示(主) | 内部キー・操作(サブ) | 製品既定値・初期状態 |
|---|---|---|
| Add your own / ローカル MCP サーバーの追加 | mcp_servers.<name> を追加 | 該当なし |
| サーバー一覧の各名前 | mcp_servers.<name> | 一覧は空 |
| サーバー JSON | mcp_servers.<name> の値 | {"command":"","args":[],"env":{}} |
| MCP を再読み込み | Gateway RPC reload.mcp | 該当なし |
| ホスト型アプリの Connect | Nous ツールゲートウェイ経由でブラウザーサインイン。Nous アカウントが無くても初回利用時にコネクタ専用の無料 ID が作られる | tools.connectors.enabled: true / nous.guest: true |
tools.connectors.enabled: false でホスト型コネクタを無効にでき、nous.guest: false で無料 ID の自動作成を止められる。mcp.auto_reload_on_config_change(既定 オン、設定変更時の自動再読み込み)、mcp.discovery_concurrency(4)は GUI 項目を持たない config 専用キー。「スキルとツール」のタブは スキル / ツールセット / Connectors / Plugins の 4 つ(Connectors と Plugins は英語表示)。
サイドバー下部
Section titled “サイドバー下部”- 設定を書き出す
- 設定を読み込む
- デフォルトに戻す
© 2026 Hermes Desktop ガイド(非公式)。引用・部分転載は、出典として本ページへのリンクを添えていただければ歓迎します。記事全文の無断複製・転載はご遠慮ください。