コンテンツにスキップ

全設定項目索引

設定画面の順序と項目のチェック用索引。実機の日本語 UI と、同一コミットのソース(設定画面定義・日本語ラベル i18n/ja.ts・バックエンド既定値 DEFAULT_CONFIG)を突き合わせて作成している。採取と照合の履歴は バージョンと調査根拠 を参照。

設定画面は 18 画面で構成される。MCP は設定タブになく、Capabilities ページ(/skills?tab=mcp)にある(本ページ末尾の「MCP」を参照)。ナビの並び順は次のとおり(区切り線 2 本を含む)。

  1. 設定セクション 9 つ(モデル / チャット / 外観 / ワークスペース / 安全性 / Browser / メモリとコンテキスト / 音声 / 詳細)
  2. 通知 → 請求
  3. ─ 区切り ─ プロバイダー(サブ: アカウント / API キー / カスタムエンドポイント / ローカルモデル) → ゲートウェイ → キーボードショートカット → ツールとキー(サブ: ツール / 設定) → Plugins → アーカイブ済みチャット
  4. ─ 区切り ─ 情報

「Browser」「Plugins」は日本語 UI でもナビラベルが英語のまま(日本語リソース未整備)。プロバイダーの「ローカルモデル」サブビューは hermes desktop --local で起動したときだけ表示され、通常起動では 3 件になる。

表の「画面表示(主)」は実際に見える文字列、「内部キー(サブ)」は設定 API・設定ファイル・.env・デスクトップ保存領域で使う名前。内部キーだけを画面ラベルとして扱わない。ボタンなど永続キーを持たないものは、内部操作名または「操作・保存キーなし」、既定値は「該当なし」と記載する。「未設定(実効: 値)」は、保存値は空だが実行時に括弧内へ解決されることを示す。一部の画面は日本語リソースが未整備で、本文が英語表示のまま(ナビラベルのみ日本語)。該当箇所は行内に明記する。

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
検索 ⌘K(設定カード上端のピル)⌘K コマンドパレットの設定スコープを開く。設定画面で入力欄の外に文字を打っても開く常時表示
適用対象(プロファイルチップ列)UI 状態 $settingsScopeOverride。この画面の編集をどのプロファイルの config.yaml に書くかを選ぶアクティブプロファイル。プロファイルが 2 つ以上あるときだけ表示
ディープリンク/settings?tab=<画面>&key=<ENV_KEY> / ?tab=plugins&plugin=<id> で該当行へスクロールと強調該当なし

「適用対象」が出る画面は、モデル / チャット / ワークスペース / 安全性 / Browser / メモリとコンテキスト / 音声 / 詳細 / ツールとキー(いずれも config.yaml 由来)。外観・通知・請求・ゲートウェイ・キーボードショートカット・Plugins・アーカイブ済みチャット・情報には出ない(端末ローカルまたはマシン単位の設定)。Plugins の Agent plugins には別に「Applies to:」セレクタがある。

「モデル」の設定ページを見る

画面表示(主)内部キー・対象(サブ)製品既定値
プロバイダーmodel.provider未設定
モデルmodel.default未設定
適用model.provider + model.default を保存該当なし
推論レベル(Defaults / Reasoning)agent.reasoning_effortmedium(中)
補助モデル下記8タスク全タスク provider: auto, model: ""
ビジョンauxiliary.vision.provider / auxiliary.vision.modelauto / 空欄
圧縮auxiliary.compression.provider / auxiliary.compression.modelauto / 空欄
スキルハブauxiliary.skills_hub.provider / auxiliary.skills_hub.modelauto / 空欄
承認auxiliary.approval.provider / auxiliary.approval.modelauto / 空欄
MCPauxiliary.mcp.provider / auxiliary.mcp.modelauto / 空欄
タイトル生成auxiliary.title_generation.provider / auxiliary.title_generation.modelauto / 空欄
レビュー(/review レビューサブエージェント)auxiliary.review.provider / auxiliary.review.modelauto / 空欄
キュレーターauxiliary.curator.provider / auxiliary.curator.modelauto / 空欄
バックエンドを再起動読込・保存エラーがコードスキュー(更新後にバックエンドが古いコードのまま)のときだけ表示該当なし
コンテキストウィンドウmodel_context_length0 相当(自動)
フォールバックモデルfallback_providers空配列
Mixture of Agents(MoA)プリセットmoa.default_preset / moa.presets.*雛形プリセット default 入り(default_preset: default
MoA 参照モデル・アグリゲーターの有効化トグルmoa.presets.*.reference_models[].enabled / moa.presets.*.aggregator.enabled有効

推論レベルの選択肢は 8 段階: Off(none)/ 最小(minimal)/ 低(low)/ 中(medium)/ 高(high)/ 特高(xhigh)/ 最大(max)/ ウルトラ(ultra)。サブエージェント推論強度(delegation.reasoning_effort、08 詳細)も同じ段階を使う。MoA の参照・集約スロットにはスロット別 reasoning_effort を保存できるが、デスクトップ画面には編集欄がない(設定ファイル側の値を保持するのみ)。既定プリセット defaultaggregator_temperature / reference_temperature は含まれない。

メインモデル直下の Defaults ブロックには推論レベル(agent.reasoning_effort、既定 medium)が表示され、対応モデルでは「高速(Fast)」トグル(agent.service_tier: fast / normal)も並ぶ。設定画面の補助モデルは上記 8 タスクのみ(「ウェブ抽出」は廃止され、auxiliary.web_extract.* は既定値定義から消えている)。モデル割り当て API には auxiliary.triage_specifier / kanban_decomposer / profile_describer も含まれるが画面には出ない。config にはさらに memory_query_rewrite / tts_audio_tags / goal_judge / monitor の各タスク、auxiliary.background_review.*(既定 オン・max_input_tokens600000)、auxiliary.transient_retries(既定 2)があり、memory_query_rewrite を除くほぼ全補助タスクで reasoning_effort(既定 空欄 = プロバイダー既定)を指定できる。メインモデルの変更がスケジュール済みジョブに影響する場合は「スケジュール済みジョブの確認が必要です」の警告が出る。

「チャット」の設定ページを見る

画面表示(主)内部キー(サブ)製品既定値
人格display.personality空欄(なし)
タイムゾーンtimezone空欄(システム)
推論ブロックdisplay.show_reasoningオン
画像添付agent.image_input_modeauto
Max preview / image load size(英語表示)store/data-url-read-max(デバイスローカル)該当なし(デバイス保存)

人格候補: なし、Helpful、Concise、Technical、Creative、Teacher、Kawaii、Catgirl、Pirate、Shakespeare、Surfer、Noir、Uwu、Philosopher、Hype。カスタム人格が設定されている場合は追加表示される。

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_timeout900 秒)がある。

「外観」の設定ページを見る

画面表示(主)内部キー(サブ)候補製品初期値
言語display.languageEnglish / 简体中文 / 繁體中文 / 日本語English
カラーモードlocalStorage: hermes-desktop-mode-v1ライト / ダーク / システムライト
テーマlocalStorage: hermes-desktop-theme-v2Slate / Nous / GitHub / Catppuccin / Everforest / Solarized / Nous Alt / Midnight / Ember / Mono / Cyberpunk(VS Code Marketplace の検索欄付き)Nous
UI スケールメインプロセスが保存(Ctrl/Cmd の +/−/0 と連動)90 / 100 / 110 / 125 / 150 / 175%90%
ターミナルフォントterminal.font_family未設定(実効: 内蔵 JetBrains Mono)
セッションリストの密度store/session-list-density(デバイスローカル)コンパクト / 標準 / 詳細該当なし(デバイス保存)
タブバーstore/tabstrip-prefs(デバイスローカル)自動 / 常に表示 / 表示しない該当なし(デバイス保存)
ウィンドウの透過store/translucency(デバイスローカル)モード クリア / ガラス。クリアはスライダー 1 本、ガラスは色味 / フェード / くもりの質感(深い / やわらか / 明るい / まぶしい。Windows は 3 段)/ 適用範囲(ウィンドウ全体 / サイドバーのみ)。Linux では非表示0(不透明)
チャット背景localStorage: hermes.desktop.backdrop.v1オン / オフオン
イントロ表示store/intro-splash(デバイスローカル)オン / オフ該当なし(デバイス保存)
フローティング入力欄store/composer-popout(デバイスローカル)トグル該当なし(デバイス保存)
アプリ内ヒントstore/tips(デバイスローカル)オフ / オン。閉じたヒントがあれば「閉じた N 件のヒントを元に戻す」ボタン該当なし(デバイス保存)
ガイドツアーstore/tours(デバイスローカル)オフ / オン該当なし(デバイス保存)
バイブハートstore/vibe-hearts-enabled(デバイスローカル)オフ / オン該当なし(デバイス保存)
ツール呼び出しの表示localStorage: hermes.desktop.toolView.technicalプロダクト / テクニカルプロダクト(false
思考ブロックをデフォルトで折りたたむstore/reasoning-disclosure(デバイスローカル)オフ / オン該当なし(デバイス保存)
インライン埋め込みlocalStorage: hermes.desktop.embed-mode / .embed-allowed確認 / 常に / オフ確認(ask
ペットdisplay.pet.enabled / .slug / .scale ほかオフ / ペット選択 / サイズ / 散歩オフ
メッセージリアクションstore/reactions-enabled(デバイスローカル)該当なし(デバイス保存)

セッションリストの密度・タブバー・イントロ表示・フローティング入力欄・アプリ内ヒント・ガイドツアー・バイブハート・思考ブロックの折りたたみの 8 項目はいずれも端末ローカル設定で、config.yaml には入らない(初期値はソースの nanostore 既定値を個別に確認していないため「該当なし」とした)。透過の各サブ設定(色味 / フェード / くもりの質感 / 適用範囲 / クリア・ガラス切替)と「イントロ表示」「フローティング入力欄」は実機で確認済み。

「ワークスペース」の設定ページを見る

画面表示(主)内部キー(サブ)製品既定値
作業ディレクトリterminal.cwd.
リポジトリの自動検出desktop.repo_scan_enabledオン
リポジトリの検索ルートdesktop.repo_scan_roots空配列(ホームディレクトリを検索)
除外するリポジトリパスdesktop.repo_scan_exclude_paths空配列
コード実行モードcode_execution.modeproject
永続シェルterminal.persistent_shellオン
環境変数の引き継ぎterminal.env_passthrough空配列
ファイル読み取り上限file_read_max_chars100000 文字

「安全性」の設定ページを見る

画面表示(主)内部キー(サブ)製品既定値
承認モードapprovals.modesmart(候補: manual / smart / off
承認タイムアウトapprovals.timeout300
MCP 再読み込みの確認approvals.mcp_reload_confirmオン
コマンド許可リストcommand_allowlist空配列
シークレットを伏せる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.transportbuiltin)/ security.approval.transport_fallbackdeny)、security.allow_data_training_tiers_noninteractive(オフ)も config 専用キー。

「Browser」の設定ページを見る

ナビラベル・見出しは日本語 UI でも英語 Browser(日本語リソース未整備)。1 行目はラベル・説明とも英語表示。

画面表示(主)内部キー(サブ)製品既定値
Use My Real Browser Profile(英語表示)browser.use_real_profileオフ
ブラウザーのプライベート URLbrowser.allow_private_urlsオフ
プライベート 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_threshold15000)/ browser.extension_control.enableddeveloper_mode(各オフ)は GUI 項目を持たない config 専用キー。

「メモリとコンテキスト」の設定ページを見る

画面表示(主)内部キー(サブ)製品既定値
永続メモリmemory.memory_enabledオン
ユーザープロファイルmemory.user_profile_enabledオン
メモリ予算memory.memory_char_limit2200 文字
プロファイル予算memory.user_char_limit1375 文字
メモリプロバイダーmemory.provider空欄(内蔵のみ。候補: honcho / hindsight)
接続(プロバイダー OAuth)startMemoryProviderOAuth(操作)プロバイダー選択時のみ表示
コンテキストエンジンcontext.enginecompressor
自動圧縮compression.enabledオン
圧縮しきい値compression.threshold0.5
圧縮目標compression.target_ratio0.2
保護する直近メッセージcompression.protect_last_n20

メモリプロバイダーの設定 UI は、宣言的なパネル+設定モーダル(プロバイダー固有フィールドをスキーマから生成)で構成される。compression.codex_app_server_auto(既定 native、Codex app-server 実行時の圧縮経路)は GUI 項目を持たない config 専用キー。

「音声」の設定ページを見る

画面表示(主)内部キー(サブ)製品既定値
音声合成プロバイダーtts.provideredge
音声認識stt.enabledオン
Echo Transcripts(英語表示)stt.echo_transcriptsオン
音声認識プロバイダーstt.provider未設定(実効: 自動検出でローカル優先。既定値定義からは削除され、実機は Local 表示)
応答を読み上げるvoice.auto_ttsオフ
音声ショートカットvoice.record_keyctrl+b
最大録音時間voice.max_recording_seconds120
Client Direct(英語表示・説明なし。画面末尾)voice.client_directオン(リモートクライアントが STT / TTS を直接呼ぶ。オフでゲートウェイ経由)
Edge 音声tts.edge.voiceen-US-AriaNeural
OpenAI TTS モデルtts.openai.modelgpt-4o-mini-tts
OpenAI 音声tts.openai.voicealloy
ElevenLabs 音声tts.elevenlabs.voice_idpNInz6obpgDQGcFmaJgB
ElevenLabs モデルtts.elevenlabs.model_ideleven_multilingual_v2
xAI (Grok) 音声tts.xai.voice_ideve
xAI 言語tts.xai.languageen
再生速度tts.xai.speed1.0(0.7〜1.5)
自動音声タグtts.xai.auto_speech_tagsオフ
ストリーミング遅延最適化tts.xai.optimize_streaming_latency0(0〜2)
サンプルレートtts.xai.sample_rate24000
ビットレートtts.xai.bit_rate128000
MiniMax TTS モデルtts.minimax.modelspeech-02-hd
MiniMax 音声tts.minimax.voice_idEnglish_expressive_narrator
Mistral TTS モデルtts.mistral.modelvoxtral-mini-tts-2603
Mistral 音声tts.mistral.voice_id音声 UUID
Gemini TTS モデルtts.gemini.modelgemini-2.5-flash-preview-tts
Gemini 音声tts.gemini.voiceKore
NeuTTS モデルtts.neutts.modelneuphonic/neutts-air-q4-gguf
NeuTTS デバイスtts.neutts.devicecpu
KittenTTS モデルtts.kittentts.modelKittenML/kitten-tts-nano-0.8-int8
KittenTTS 音声tts.kittentts.voiceJasper
Piper 音声tts.piper.voiceen_US-lessac-medium
DeepInfra TTS Model(英語表示)tts.deepinfra.model空欄(カタログ先頭の TTS モデル)
DeepInfra Voice(英語表示)tts.deepinfra.voicedefault
ローカル文字起こしモデルstt.local.modelbase
文字起こし言語stt.local.language空欄(自動)
OpenAI STT モデルstt.openai.modelwhisper-1
Groq STT モデルstt.groq.model未設定(既定値なし)
Mistral STT モデルstt.mistral.modelvoxtral-mini-latest
ElevenLabs STT モデルstt.elevenlabs.model_idscribe_v2
ElevenLabs 言語stt.elevenlabs.language_code空欄(自動)
音声イベントをタグ付けstt.elevenlabs.tag_audio_eventsオフ
話者分離stt.elevenlabs.diarizeオフ

TTS プロバイダーのドロップダウンは edge / elevenlabs / openai / xai / minimax / mistral / gemini / neutts / kittentts / piper の10種、STT プロバイダーは local / groq / openai / mistral / xai / elevenlabs の6種。config.yaml で定義したカスタム(コマンド型)TTS / STT プロバイダーも候補に加わる。DeepInfra はドロップダウンに出ないが入力欄(TTS モデル・音声)を持ち、バックエンド側では STT プロバイダー deepinfrastt.deepinfra.model、既定 空欄)も定義されている。voice.submit_mode(既定 direct)は GUI 項目を持たない config 専用キー。

OpenAI STT のモデル選択肢には gpt-transcribe が加わっている。OpenAI TTS の音声候補は選択中のモデルに応じて絞り込まれ、tts-1 / tts-1-hd では 9 音声のみ選べる(残り 4 音声は gpt-4o-mini-tts 専用)。

「詳細」の設定ページを見る

画面表示(主)内部キー(サブ)製品既定値
有効なツールセットtoolsets["hermes-cli"]
実行バックエンドterminal.backendlocal
Docker イメージterminal.docker_imagenikolaik/python-nodejs:python3.11-nodejs20
Singularity イメージterminal.singularity_imagedocker://nikolaik/python-nodejs:python3.11-nodejs20
Modal イメージterminal.modal_imagenikolaik/python-nodejs:python3.11-nodejs20
Daytona イメージterminal.daytona_imagenikolaik/python-nodejs:python3.11-nodejs20
コマンドタイムアウトterminal.timeout180
ターミナル出力上限tool_output.max_bytes50000 bytes
ファイルページ上限tool_output.max_lines2000
行長上限tool_output.max_line_length2000 文字
チェックポイント上限checkpoints.max_snapshots20
最大エージェントステップagent.max_turnsnull(画面では空欄=上限なし。数値を入れると上限になる)
API 再試行回数agent.api_max_retries3
サービス階層agent.service_tier空欄
ツール使用の強制agent.tool_use_enforcementauto
サブエージェントモデルdelegation.model空欄
サブエージェントプロバイダーdelegation.provider空欄
サブエージェントターン上限delegation.max_iterations250
並列サブエージェントdelegation.max_concurrent_children10
サブエージェントタイムアウトdelegation.child_timeout_seconds0 秒(上限なし。0 で wall-clock キャップ無効。子エージェントごとの任意上限)
サブエージェント推論強度delegation.reasoning_effort空欄(親を継承。候補は 01 モデルと同じ 8 段階)
アプリ内更新時のローカル変更updates.non_interactive_local_changesstash
コンピューターをスリープさせない端末ローカル設定(画面最上部。OS のパワーセーブブロッカー)オフ
Disable F12 DevTools(英語表示)store/disable-f12(デバイスローカル。スリープ抑止の直下)オフ
クイック入力store/quick-entry(デバイスローカル)有効(⌘ ⇧ Space

実行バックエンドの選択は、ヘルスチェック(到達確認)付きのパネルで行う。「有効なツールセット」を空にする編集は、適用前に確認ダイアログ(英語表示)を挟む。自動保存は差分保存で、画面を開いている間に外部(hermes config set など)で変わった項目を古い値で上書きしない。バックグラウンドサブエージェント専用上限だった delegation.max_async_children は廃止され、delegation.max_concurrent_children に一本化されている。terminal.docker_network(既定 オン。オフで Docker バックエンドのネットワークを遮断)は config 専用キーで、この画面に項目はない。

「通知」の設定ページを見る

画面表示(主)内部キー(サブ)製品既定値
通知を有効にする(マスタートグル)OS ネイティブ通知の有効化オン
承認が必要approvalオン
入力が必要inputオン
応答完了turnDoneオン
ターン失敗turnErrorオン
バックグラウンドタスク完了backgroundDoneオン
クレジット通知creditsオン
プラグイン通知pluginオン
完了サウンド通知サウンドの選択
テスト通知を送信テスト通知の送信該当なし

対象 OS は macOS / Windows。

Nous Portal のサブスクリプションとクレジット残高をアプリ内で確認・操作する画面。ナビラベルは「請求」(日本語)だが、画面本文は英語表示。プラン変更やカード管理は課金ポータルへのリンク(opens portal)で行う。TUI / CLI の /subscription /topup と同じ課金 API を使う。

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
Billing(見出し)+ Refresh課金状態の再取得該当なし
Plan / Balance / Auto-refill(サマリーカード)課金 API の現在値表示未接続時は空表示
Account(セクション)以下 4 行をまとめる見出し該当なし
Subscriptionプラン表示・変更(ポータルへ deep link)現在のプラン、または未加入
Payment method支払いカードの表示・更新(ポータル)No card on file
Buy creditsトップアップクレジットの購入カード未登録時は無効
Auto-refill自動リフィルのしきい値・補充額の設定オフ
Usage(セクション)使用状況の表示

Plan カードの「プランを見る」からは、概要ビューとは別の「プラン比較」ビューへ遷移する。プラン比較ビューでは下位プランへの変更時にダウングレード確認ダイアログが挟まり、ティアごとに専用アートワークが表示され、値上げ前の旧価格は取り消し線付きで併記される。クレジットの自動リロード(Auto-refill)もこの画面から設定する。

設定ファイルに保存されるキーはない(課金状態は Nous Portal 側で管理される)。

「プロバイダー」の設定ページを見る

サブメニュー: アカウント / API キー / カスタムエンドポイント / ローカルモデルhermes desktop --local 起動時のみ)の 4 つ。通常起動では 3 つ。

アカウントと API キーの一覧は、統合プロバイダーカタログ(hermes_cli/provider_catalog.py)から生成される。アカウント画面は初回オンボーディングと同型のピッカーで、推奨カード(Nous Portal)が常時表示され、接続済み以外のプロバイダーは開示式(「その他」)に畳まれる。2 番目のスロットは --local 起動時のみ「ローカルモデル」行になり、Fireworks AI は OpenRouter と並んで「その他のプロバイダー」の折りたたみ内にある。切断の確認はアプリ内ダイアログ(「切断」)。Base URL・別名キー・英語ラベルの詳細は プロバイダー を正とする。

画面表示(主)プロバイダー ID(サブ)製品初期状態
Nous Portalnous未接続(「推奨」バッジ)
OpenAI OAuth (ChatGPT)openai-codex未接続
xAI Grokxai-oauth未接続
Anthropic OAuth: Required Extra Usage Credits to Use Subscriptionclaude-code未接続
MiniMaxminimax-oauth未接続
Qwen Codeqwen-oauth未接続
Anthropic API Keyanthropic未接続
GitHub Copilot (ACP)copilot-acp未接続
OpenRouteropenrouter(API キー側へ誘導する固定行)未接続

明示カードの OAuth カタログ(nous / openai-codex / qwen-oauth / minimax-oauth / xai-oauth / copilot-acp / anthropic / claude-code の 8 件)に、統合カタログのアカウント型プロバイダーが自動追加される。Google Vertex AI(vertex)はカタログ上のプロバイダーで、アカウント一覧にはカード表示されない(2026-07-02 実機画面で確認。利用は CLI・設定ファイルから)。

主キーのみ記載。展開時の Base URL・設定済み時だけ残る別名キーは プロバイダー(API キー) を参照。

画面表示(主)内部キー(サブ・主キー)製品既定値
1OpenRouterOPENROUTER_API_KEY未設定
2AnthropicANTHROPIC_API_KEY未設定
3xAIXAI_API_KEY未設定
4DeepSeekDEEPSEEK_API_KEY未設定
5MiniMaxMINIMAX_API_KEY未設定
6MiniMax (China)MINIMAX_CN_API_KEY未設定
7OpenCode ZenOPENCODE_ZEN_API_KEY未設定
8OpenCode GoOPENCODE_GO_API_KEY未設定
9NVIDIA NIMNVIDIA_API_KEY未設定
10Ollama CloudOLLAMA_API_KEY未設定
11LM StudioLM_API_KEY未設定
12Xiaomi MiMoXIAOMI_API_KEY未設定
13Arcee AIARCEEAI_API_KEY未設定
14GMI CloudGMI_API_KEY未設定
15Azure FoundryAZURE_FOUNDRY_API_KEY未設定
16Alibaba Cloud (Coding Plan)ALIBABA_CODING_PLAN_API_KEY未設定
17GitHub CopilotCOPILOT_GITHUB_TOKEN未設定
18Google AI StudioGOOGLE_API_KEY未設定
19HuggingFaceHF_TOKEN未設定
20Kilo CodeKILOCODE_API_KEY未設定
21Kimi / Kimi Coding PlanKIMI_API_KEY未設定
22Kimi / Moonshot (China)KIMI_CN_API_KEY未設定
23NovitaAINOVITA_API_KEY未設定
24OpenAI APIOPENAI_API_KEY未設定
25Qwen CloudDASHSCOPE_API_KEY未設定
26StepFun Step PlanSTEPFUN_API_KEY未設定
27Tencent TokenHubTOKENHUB_API_KEY未設定
28Z.AI (GLM)GLM_API_KEY未設定

旧「Gemini」カード(HERMES_GEMINI_CLIENT_SECRET)は廃止され、Google の API キーは「Google AI Studio」(GOOGLE_API_KEY)カードに集約されている。NOUS_BASE_URL / HERMES_QWEN_BASE_URL / AWS_REGION / AWS_PROFILE / BEDROCK_BASE_URL はカタログに存在するがカード化されない。

Fireworks AIFIREWORKS_API_KEY)と UpstageUPSTAGE_API_KEY、詳細に UPSTAGE_BASE_URL)のカードもある。一覧内の表示位置が実機未採取のため、上表には含めていない(プロバイダーカテゴリの env カタログで確認)。

OpenAI 互換のカスタムエンドポイント(ローカル LLM サーバー・プロキシ等)を登録してメインモデルに使う画面。ナビラベルは「カスタムエンドポイント」(日本語)、画面本文は英語表示。保存先は config.yamlproviders.<ID> エントリ(既存の手書きキーはマージ保持される)。

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
Custom Endpoints(一覧)providers.<id>config.yaml0 件(No custom endpoints)
Use該当エンドポイントをメインモデルに切り替え該当なし
Delete endpointproviders.<id> を削除(config.yaml 直書き分は削除不可)該当なし
Add Endpoint / Edit Endpoint(フォーム見出し)UI 状態Add Endpoint
Name表示名空欄
Provider IDproviders のキー名空欄
Endpoint URLproviders.<id>.base_url空欄
Default Modelproviders.<id>.model空欄
Contextproviders.<id>.context_length空欄(Auto)
API Keyproviders.<id>.api_key空欄(任意)
Use for new chats保存時にメインモデルへ設定オン
Discover models/models からモデル一覧を取得オン
Testエンドポイント到達確認該当なし
Saveフォーム内容を保存該当なし

ローカルモデル(--local 起動時のみ)

Section titled “ローカルモデル(--local 起動時のみ)”

hermes desktop --local(Windows は Hermes.exe --local)で起動したときだけ表示されるサブビュー。フラグ無しでは ?pview=local を指定しても描画されない。画面本文は日本語。--local 起動の実機で、ランタイム未インストール状態の画面(ローカルランタイム / このマシン / モデル 4 件 / さらにモデルを探す / モデルファイルを追加)を確認済み。インストール後の状態表示はソース差分に基づく。

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
ローカルランタイム(インストール / 更新 / オン・オフ / 状態)local_runtime.enabled / local_runtime.backend / local_runtime.tagオフ / auto / b10679(llama.cpp のビルドタグ)
このマシン(GPU メモリ・RAM・ユニファイドメモリ)ハードウェア判定の表示該当なし
モデル(おすすめ / ダウンロード / 使用する / 読み込み・アンロード / 配置・適合バッジ)local_runtime.models_max4
さらにモデルを探す(Hugging Face 検索・GGUF の手動追加)操作・保存キーなし該当なし
ポートlocal_runtime.port / local_runtime.detect_ports0(自動)/ 空配列

「ゲートウェイ」の設定ページを見る

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
env オーバーライドHERMES_DESKTOP_REMOTE_URL(token 時は HERMES_DESKTOP_REMOTE_TOKEN未設定(envOverride: false
ローカルゲートウェイconnection.jsonmode: localmode: local
リモートゲートウェイmode: remote未選択
Hermes Cloud(説明は英語表示)mode: cloud(サインインしてアカウントのエージェントを選択。URL 入力不要)未選択
SSH で接続mode: sshuser@host または ~/.ssh/config の Host エイリアス。ホスト鍵は初回信頼で固定)未選択
リモート URLremote.url空欄
認証remote.authModetoken(URL 調査結果で上書き)
セッショントークンremote.token未設定
トークンは平文で保存されています(警告バナー)remoteTokenPlainText(セキュアストレージが無い環境で平文保存に同意したとき)非表示
リモートをテストtestConnectionConfig(...)該当なし
次回起動時のために保存saveConnectionConfig(...)(平文保存になる場合は確認ダイアログ「平文で保存」)該当なし
保存して再接続applyConnectionConfig(...)該当なし
サインアウトoauthLogoutConnectionConfig(...)該当なし
OS キーチェーンで保存済みのシークレットを暗号化setSecretStorageEncryption(Keychain Access / GNOME Keyring / Windows DPAPI)オフ
診断操作・保存キーなし該当なし
ログを開くrevealLogs()該当なし
Registered gateways(英語表示・セクション)登録済み接続の一覧(This device / Remote gateway / Hermes Cloud / SSH)。ピル Current / Primary / App-managedThis device のみ
Add connection / 編集 / 削除 / Make primary / Test接続の追加・編集・削除・プライマリ設定・疎通テスト(Reachable該当なし
Extra gateway headers(英語表示)追加ヘッダー(Cloudflare Access 等)。値は暗号化保存空欄
Update all instances登録済み全インスタンスの一括更新(Hermes Cloud 管理分はスキップ)該当なし
At startup, return to Sessions on the last-used gateway(英語表示)起動時に最後に使ったゲートウェイのセッションへ戻る。オフでプライマリを開くオフ
Managed updates(英語表示・セクション)SSH 種別の接続が 1 件以上あるときだけ表示。接続ごとの Update非表示

接続モードは ローカル / リモート / Hermes Cloud / SSH の 4 択。接続設定はマシン単位で、プロファイル別の「適用対象」スコープと「デフォルトゲートウェイを使用」カード、SSH の「リモートプロファイル(任意)」欄は無い(プロファイルは接続先ゲートウェイから検出される)。Registered gateways 以降のセクションは日本語リソースが無く英語表示。旧 ?tab=connections はこの画面へリダイレクトされる。

デスクトップアプリのショートカットを検索・再割り当てする画面。ナビラベルは「キーボードショートカット」(日本語)、画面本文(Keyboard shortcuts)は英語表示。変更分だけが localStorage: hermes.desktop.keybinds に保存される(既定値との差分保存)。

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
Keyboard shortcuts(見出し)操作・保存キーなし該当なし
Search shortcuts…(検索欄)ラベル・ID でのフィルタ空欄
カテゴリ見出しComposer / Profiles / Session / Navigation / View全カテゴリ展開
各アクション行localStorage: hermes.desktop.keybinds既定コンボ表示
Rebindキー入力待ち(Press a key…)にして再割り当て該当なし
Reset to default該当アクションを既定に戻す該当なし
Reset all全アクションを既定に戻す該当なし
変更不可の行読み取り専用ショートカット(rebind 不可。Focus composer ⌘L、Move HUD to pointer ⌘⇧G など)固定表示

既定マップの正本は apps/desktop/src/lib/keybinds/actions.ts。主な既定: session.new は ⌘N のみ(shift+n は外れた)、session.next / session.prev は Ctrl+Tab / Ctrl+Shift+Tab に加えて Ctrl+PageDown / PageUp、view.toggleTabStrip(Toggle tabs)は ⌘⌥T、view.showBrowser(Open browser)は ⌘⇧L、session.archive は既定なし、view.selectionToComposer(Send selection to composer)は ⌘L。SESSIONS / NAVIGATION 帯を含め、既定マップは実機の一覧と一致することを確認済み。

「ツールとキー」の設定ページを見る

サブメニュー: ツール / 設定

画面表示(主)内部キー(サブ)製品既定値
1AGENT BROWSER ENGINEAGENT_BROWSER_ENGINE未設定(実効: auto
2BRAVE SEARCHBRAVE_SEARCH_API_KEY未設定
3BROWSER USEBROWSER_USE_API_KEY未設定
4BROWSERBASEBROWSERBASE_API_KEY未設定
5BROWSERBASE PROJECT IDBROWSERBASE_PROJECT_ID未設定
6BRVBRV_API_KEY未設定
7CAMOFOXCAMOFOX_API_KEY未設定
8CAMOFOX URLCAMOFOX_URL未設定
9ELEVENLABSELEVENLABS_API_KEY未設定
10EXAEXA_API_KEY未設定
11FALFAL_KEY未設定
12FIRECRAWLFIRECRAWL_API_KEY未設定
13FIRECRAWL API URLFIRECRAWL_API_URL未設定
14FIRECRAWL BROWSER TTLFIRECRAWL_BROWSER_TTL未設定(実効: 300 秒)
15FIRECRAWL GATEWAY URLFIRECRAWL_GATEWAY_URL未設定
16GITHUBGITHUB_TOKEN未設定
17HERMES LANGFUSE BASE URLHERMES_LANGFUSE_BASE_URL未設定(実効: https://cloud.langfuse.com
18HERMES LANGFUSE PUBLICHERMES_LANGFUSE_PUBLIC_KEY未設定
19HERMES LANGFUSE SECRETHERMES_LANGFUSE_SECRET_KEY未設定
20HINDSIGHTHINDSIGHT_API_KEY未設定
21HINDSIGHT API URLHINDSIGHT_API_URL未設定(実効: https://api.hindsight.vectorize.io
22HONCHOHONCHO_API_KEY未設定
23HONCHO BASE URLHONCHO_BASE_URL未設定
24KEENABLEKEENABLE_API_KEY未設定(キー無しの無料枠でも動作)
25KREAKREA_API_KEY未設定
26MEM0MEM0_API_KEY未設定
27MISTRALMISTRAL_API_KEY未設定
28OPENVIKINGOPENVIKING_API_KEY未設定(ローカル開発モードでは空欄可)
29OPENVIKING ENDPOINTOPENVIKING_ENDPOINT未設定(実効: http://127.0.0.1:1933
30PARALLELPARALLEL_API_KEY未設定
31PORCUPINE ACCESSPORCUPINE_ACCESS_KEY未設定(ウェイクワードは openWakeWord が無料の既定)
32RETAINDBRETAINDB_API_KEY未設定
33RETAINDB BASE URLRETAINDB_BASE_URL未設定(実効: https://api.retaindb.com
34SEARXNG URLSEARXNG_URL未設定
35SUPERMEMORYSUPERMEMORY_API_KEY未設定
36TAVILYTAVILY_API_KEY未設定
37TOOL GATEWAY DOMAINTOOL_GATEWAY_DOMAIN未設定(実効: nousresearch.com
38TOOL GATEWAY SCHEMETOOL_GATEWAY_SCHEME未設定(実効: https
39TOOL GATEWAY USERTOOL_GATEWAY_USER_TOKEN未設定
40VOICE TOOLS OPENAIVOICE_TOOLS_OPENAI_KEY未設定

一覧はバックエンドの環境変数カタログ(OPTIONAL_ENV_VARS のカテゴリ tool)から生成され、アルファベット順に並ぶ。上表の 40 行はカタログ定義から確定した(実機スクリーンショットは先頭 15 行まで確認)。画面側は内部キー末尾の _API_KEY / _TOKEN / _KEY を省いて表示する。.env に手書きした未知のキーは「custom」として別枠で一覧に加わる。

画面表示(主)内部キー(サブ)製品既定値
1GATEWAY ALLOW ALL USERSGATEWAY_ALLOW_ALL_USERS未設定(実効: false
2GATEWAY PROXYGATEWAY_PROXY_KEY未設定
3GATEWAY PROXY URLGATEWAY_PROXY_URL未設定
4HERMES EPHEMERAL SYSTEM PROMPTHERMES_EPHEMERAL_SYSTEM_PROMPT未設定
5HERMES PREFILL MESSAGES FILEHERMES_PREFILL_MESSAGES_FILE未設定
6SUDO PASSWORDSUDO_PASSWORD未設定

「設定」には、上表のカテゴリ setting の 3 件とゲートウェイ共通の 3 件(GATEWAY_*)に加えて、メッセージングプラットフォームごとのチャネル・許可設定の変数(実機で確認したのは MATRIX / MATTERMOST / NTFY / PHOTON / QQ / QQBOT / SIMPLEX 系の * ALLOW ALL USERS / * HOME CHANNEL / * HOME CHANNEL NAME / * REQUIRE MENTION / * REPLY MODE / * FREE RESPONSE ROOMS / * FREE RESPONSE CHANNELS / MATRIX DM AUTO THREAD。右列はすべて「省略可能」)が並ぶ。総件数と先頭の行は未確認。HERMES_TOOL_PROGRESS / HERMES_TOOL_PROGRESS_MODE はこの一覧にない。ツール進捗は config.yamldisplay.tool_progress で管理する。

デスクトップアプリの UI 拡張(デスクトッププラグイン)を管理する画面。ナビラベル・本文とも英語表示(Desktop plugins)。ビルド同梱のほか、<HERMES_HOME>/desktop-plugins/ フォルダに置いたプラグイン(Hermes 自身が書いたものを含む)を読み込む。無効化は即時アンロードされ、再起動後も維持される。

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
Desktop plugins(見出し)+ N installedプラグイン一覧同梱 3 件(3 installed
Accent Picker(bundled)ステータスバーの OKLCH カラーピッカーでテーマのアクセントを試す作者向けツールオフ
Bots(bundled)Bot Mode(ボットの名簿・アバター・ルーティン・グループチャット・ボット間メッセージ)→ ボットオン
Kanban(bundled)マルチエージェントのタスクボード(ボードページ・サイドバー項目・ステータスバーの進行数)オフ
Open plugins folder<HERMES_HOME>/desktop-plugins を開く該当なし
Rescanフォルダを再スキャン該当なし
各プラグイン行の種別bundled / on disk / runtime
有効 / 無効トグルプラグインの有効・無効を切り替え有効(同梱は上記のとおり)
Reveal in file managerプラグインの場所を表示該当なし
Agent plugins(見出し)+ N installedエージェント側プラグインの一覧(同梱プラグインは除外)0 件(No agent plugins installed yet.)
Applies to:(Agent plugins)一覧・トグルの対象プロファイル。プロファイルが 2 つ以上あるときだけ表示Hermes (default)
Search plugins…エージェントプラグインの絞り込み空欄
Install plugin(モーダル・英語表示)リポジトリ URL からの導入。内容物(Agent plugin / Desktop UI)・インストール先・ソースコードの確認、Enable agent plugin after install / Force reinstall該当なし

?tab=plugins&plugin=<id> のディープリンクで該当行へスクロールする。contract v6 以前のバックエンドが返すキー無しの行は読み取り専用(Update the Hermes backend to manage this plugin from Desktop.)。

「アーカイブ済みチャット」の設定ページを見る

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
デフォルトのプロジェクトディレクトリuserData/project-dir.jsondir未設定
未設定dir なし初期表示
デフォルト: ホームディレクトリ表示用 defaultLabel(= app.getPath('home')ホームディレクトリを絶対パス表示
選択pickDefaultProjectDir()該当なし
変更setDefaultProjectDir(<path>)該当なし
クリアsetDefaultProjectDir(null)該当なし
古いチャットを自動アーカイブsessions.auto_archive / sessions.auto_archive_daysオフ / 3
アーカイブ済みセッション一覧条件 archived=only0件
アーカイブを解除対象セッションの archived: false該当なし
完全に削除対象 session.id を削除(アプリ内の確認ダイアログ「完全に削除」。未読状態も破棄)該当なし
アーカイブがありませんsessions.length === 0表示
アーカイブ済みセッションを読み込めませんでした一覧 API エラー非表示

一覧は一度に最大 200 件取得する。

「情報」の設定ページを見る

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
Hermes Desktop操作・保存キーなし該当なし
バージョン 0.21.0DesktopVersionInfo.appVersion固定値ではない(このビルドは 0.21.0
アプリのビルドが古くなっています(バナー)/ インストーラーを入手version.bundleOutOfSync(ランタイムだけ更新されデスクトップのビルドが古いとき)非表示
再起動して更新を完了(バナー)/ Hermes を再起動version.bundleSwapPending(更新済みアプリが入れ替え済みで再起動待ちのとき。上のバナーの代わりに表示)非表示
更新DesktopUpdateStatusstatus: null
今すぐ確認IPC hermes:updates:check該当なし
今すぐ更新startActiveUpdate()更新がある場合のみ表示(件数不明でも updateAvailable で表示)
新機能を見るcommits / behind / targetSha更新取得前は非表示
リリースノートRELEASE_NOTES_URLGitHub Releases URL
自動更新個別設定キーなし対応ビルドでは自動確認、個別トグルなし
ブランチ main · コミット c5c9aa8branch / currentShaブランチは main、コミットは固定値ではない
Danger zone / Uninstall HermesUninstallSection該当なし(3段階のアンインストール、英語表示)

「MCP」の設定ページを見る

MCP は設定タブではなく、Capabilities ページ(/skills?tab=mcp。サイドバーの「スキルとツール」)の MCP タブにある。旧 URL /settings?tab=mcp へのディープリンクは新しい場所へ自動リダイレクトされる(server= パラメータも引き継がれる)。項目のラベル・保存先は設定画面にあった頃と同じ。

画面表示(主)内部キー・操作(サブ)製品既定値・初期状態
新しいサーバーUI 下書き、保存キーなし該当なし
MCP を再読み込みGateway RPC reload.mcp該当なし
サーバー一覧の各名前mcp_servers.<name>一覧は空
サーバーを編集UI 見出し、保存キーなし選択なし
名前mcp_servers オブジェクトのキー空欄
サーバー JSONmcp_servers.<name> の値{"command":"","args":[],"env":{}}
削除mcp_servers.<name> を削除該当なし
サーバーを保存mcp_servers.<name> を保存該当なし

MCP タブにはサーバーごとの状態表示(接続中… / 認証が必要です / エラー / オフ)、「認証」ボタン(OAuth 対応サーバー)、ツール単位の有効・無効トグルのほか、「インポート」(mcp.json スニペット・npx / docker コマンド・claude mcp add 行・URL・Cursor リンクを貼り付けて mcp.json に追加)、サーバーごとのコスト / 使用量表示(「1 呼び出しあたり約 N トークン」「過去 30 日で N 回使用」)、hermes:// ディープリンクからの追加確認ダイアログ(「MCP サーバーを追加しますか?」)がある。「スキルとツール」のタブは スキル / ツールセット / MCP の 3 つで、Skills Hub のブラウザはスキルタブの下部に埋め込まれている。MCP タブの 3 ペイン構成(Servers + インポート + Catalog、mcp.json エディタ + 保存、ログペイン)とサーバー行の状態バッジは実機で確認済み。コスト / 使用量表示と hermes:// ディープリンクの確認ダイアログは実機未撮影で、ソース差分に基づく。mcp.auto_reload_on_config_change(既定 オン、設定変更時の自動再読み込み)は GUI 項目を持たない config 専用キー。

  • 設定を書き出す
  • 設定を読み込む
  • デフォルトに戻す

© 2026 Hermes Desktop ガイド(非公式)。引用・部分転載は、出典として本ページへのリンクを添えていただければ歓迎します。記事全文の無断複製・転載はご遠慮ください。