外観

デスクトップ UI だけに適用される表示設定。言語以外はローカル UI 設定として保存される。

画面表示（主）	内部キー（サブ）	選択肢	製品初期値	推奨
言語	display.language	English / 简体中文 / 繁體中文 / 日本語	English	日本語
カラーモード	localStorage: hermes-desktop-mode-v1	ライト / ダーク / システム	ライト	システム
UI スケール	zoom-state.json（localStorage: hermes:desktop:zoomLevel は互換ミラー）	90 / 100 / 110 / 125 / 150 / 175%	100%	100%、見づらい場合のみ上げる
テーマ	localStorage: hermes-desktop-theme-v2	Nous / Midnight / Ember / Mono / Cyberpunk / Slate	Nous	Nous または Slate
ウィンドウの透過	localStorage: hermes.desktop.translucency.v1	0〜100%（スライダー、5刻み）	0（不透明）	0、必要な場面でのみ上げる
チャット背景	localStorage: hermes.desktop.backdrop.v1	オフ / オン	オン	好みで（気になればオフ）
ツール呼び出しの表示	localStorage: hermes.desktop.toolView.technical	プロダクト / テクニカル	プロダクト	通常はプロダクト
インライン埋め込み	localStorage: hermes.desktop.embed-mode	確認 / 常に / オフ	確認（ask）	確認のまま
ペット	display.pet.enabled ほか	オフ / ペット選択 / サイズ / 散歩	オフ	好みで有効化

言語

画面表示（主）	保存値（内部）	既定	内容
English	en	はい	英語 UI
简体中文	zh	いいえ	中国語・簡体字 UI
繁體中文	zh-hant	いいえ	中国語・繁体字 UI
日本語	ja	いいえ	日本語 UI

display.language に保存される。切り替え時は設定保存が完了するまで「言語を保存中…」と表示され、保存失敗時は直前の言語へ戻る。

カラーモード

画面表示（主）	保存値（内部）	既定	動作
ライト	light	はい	常に明るい表示
ダーク	dark	いいえ	常に暗い表示
システム	system	いいえ	OS の外観設定に追従

バックエンドの config.yaml ではなく、デスクトップの localStorage に保存される。

UI スケール

アプリ全体の文字と UI の拡大率を変更する。画面の説明文は「アプリ全体の文字と UI を拡大縮小します。Cmd/Ctrl と +、-、0 でも変更できます。現在: 100%」のように、常に現在の倍率を示す。

画面表示（主）	選択肢	既定
UI スケール	90% / 100% / 110% / 125% / 150% / 175% の6プリセット	100%

• プリセット: 6つのボタンから選ぶと即時反映される。100% がブラウザ標準サイズ。
• キーボード: Cmd/Ctrl と +、-、0 でも変更できる。+ / - はプリセットより細かい刻みで動くため、プリセットの中間の倍率になることがある。その場合はどのプリセットも選択表示にならないが、説明文の「現在: N%」で実際の倍率を確認できる。0 を押すと 100% に戻る。
• マウス: Ctrl/Cmd を押しながらマウスホイールでも拡大縮小できる。
• 倍率の表示が実際の見た目と合わない場合は、説明文の「現在: N%」を確認してからプリセットを選び直す。

保存先は config.yaml ではなく、デスクトップアプリのローカルデータ ─ メインプロセスが管理する zoom-state.json（Electron の userData 配下）が正で、互換用に localStorage: hermes:desktop:zoomLevel にも同じ値を書き込む。カラーモードなどと同じデバイス単位の設定になる。なお、ペットのポップアウトウィンドウには UI スケールを適用しない（スプライトが切れるのを防ぐため）。

テーマ

画面表示（主）	保存値（内部）	既定	特徴
Nous	nous	はい	Hermes の標準テーマ。ライト時は白・青、ダーク時は濃紺・クリーム色を基調にする
Midnight	midnight	いいえ	深い青紫と寒色アクセント。暗い環境で彩度を残したい場合向け
Ember	ember	いいえ	深紅とブロンズの暖色。暗色で暖かい配色
Mono	mono	いいえ	グレースケール中心。色による注意散漫を抑えたい場合向け
Cyberpunk	cyberpunk	いいえ	黒地にネオングリーン。ターミナル風の強いコントラスト
Slate	slate	いいえ	落ち着いたスレートブルー。開発作業向けの暗色テーマ

テーマは色、チャット面、フォントの一部を変更する。機能やモデル出力には影響しない。上記のビルトイン6種に加え、VS Code Marketplace 由来のユーザーテーマが一覧へ追加され得る。

アクティブなバックエンドが display.skin を通知した場合は、その値がデスクトップテーマへ同期され、同じ localStorage キーへ反映される。

VS Code Marketplace テーマのインストール

テーマ一覧の上の検索欄（プレースホルダー「Search your themes or the VS Code Marketplace…」、英語表示）にキーワードを入れると、手持ちのテーマと Marketplace をリアルタイム検索（入力から約 300ms 後に照会）した結果が並び、そこから直接インストールできる。インストール済みのテーマは検索結果上でチェック表示になり、重複インストールを避けられる。追加したテーマはユーザーテーマとしてテーマ一覧へ並び、不要になれば一覧から削除できる。ビルトイン6種はそのまま残る。テーマはアクティブなプロファイル単位で保存され、プロファイルごとに個別のテーマを保持する。

同じ検索・インストール UI は Cmd+K パレットの「テーマをインストール」からも使える。テーマのプレビューは、現在のカラーモード（ライト / ダーク）に合わせて描画される。

ウィンドウの透過

ウィンドウ背景の透過度を 0〜100% のスライダー（5刻み）で調整する。製品初期値は 0 で、不透明（透過オフ）。

• 対象は macOS と Windows のみ。Linux では非対応。
• localStorage: hermes.desktop.translucency.v1 にデスクトップ UI 設定として保存される。

背面のウィンドウや壁紙が透けるため可読性が下がる場合がある。常用は 0 のままにし、必要な場面でのみ上げることを推奨する。

チャット背景

会話の背後にうっすら表示される彫像の画像を表示するかどうかを切り替える。画面の説明文は「会話の背後に表示される淡い彫像の画像。」で、選択肢は「オフ / オン」の切替。既定はオン。

• 純粋に表示だけの設定で、機能やモデル出力には影響しない。
• localStorage: hermes.desktop.backdrop.v1（既定 true）にデバイス単位で保存される。config.yaml には保存されない。
• 背景画像が気になる場合や、画面共有・スクリーンショットに写り込ませたくない場合はオフにする。

ツール呼び出しの表示

画面表示（主）	UI 内部値	保存値（内部）	既定	動作
プロダクト	product	false	はい	生の引数・結果を隠し、読みやすい活動表示と要約を示す
テクニカル	technical	true	いいえ	ツールの入力、出力、低レベル情報を表示する

一般利用はプロダクト、ツール失敗の診断やプロンプト開発はテクニカルを推奨する。認証情報を扱う環境では、画面共有前にテクニカル表示の内容を確認する。

インライン埋め込み

チャット内のリンクに対するリッチプレビュー（YouTube・X などの埋め込み）の読み込み方針を選ぶ。画面の説明文のとおり、リッチプレビューは第三者サイトから読み込まれるため、プライバシー方針に応じて選択する。

画面表示（主）	保存値（内部）	既定	動作
確認	ask	はい	許可するまでプレースホルダーを表示し、クリックで個別に許可する
常に	always	いいえ	自動で読み込む
オフ	off	いいえ	リンクのまま表示する

• 画面ラベルは「インライン埋め込み」、選択肢は「確認 / 常に / オフ」の切替で、既定は「確認」。
• localStorage: hermes.desktop.embed-mode（既定 ask）にデバイス単位で保存される。
• 「確認」で個別に許可したサービスは localStorage: hermes.desktop.embed-allowed に蓄積され、「許可した N 件のサービスをリセット」ボタンでまとめて取り消せる。
• 第三者サイトへの接続はアクセス元の情報（IP など）を先方へ渡すため、機微な作業環境では「確認」のまま、または「オフ」を推奨する。

ペット（Petdex マスコット）

エージェントの活動に反応する小さなアニメーションマスコット（ペット）を表示できる。ペットは petdex ギャラリー由来のスプライトで、ツール実行中は走り、成功すると喜び、エラーでしょんぼりと、Hermes の状態に反応する。純粋に装飾で、プロンプトキャッシュ・トークン・エージェントの挙動には一切影響しない。既定はオフで、ペットを選ぶまで表示されない。

デスクトップでは 設定 → 外観のこのセクションで管理する。CLI・TUI にも同じペットが表示される。

画面表示（主）	内部キー・対象（サブ）	選択肢・値	製品初期値
ペット（オン/オフ）	display.pet.enabled	オン / オフ	オフ
ペットを選ぶ	display.pet.slug	ギャラリーから採用	空（未選択）
サイズ	display.pet.scale	スライダー（約 10〜300%、初期値 33%）	0.33
散歩	localStorage: hermes.desktop.pet-roam.v1	オン / オフ	オフ

操作

• オン/オフ: 「ペットを選ぶ」の右にある「オフ / オン」の切替。オンにするとインストール済みの先頭のペットが採用される。オンにできるペットが無い場合はメッセージが出る。
• ペットを選ぶ: 検索欄（「ペットを検索…」）でギャラリーを絞り込み、カードを選ぶと（必要に応じて）インストールされてアクティブになる。一覧は一部のみ表示され、下部に「3313 件中 60 件を表示中」のような件数が出る。生成したペットには「生成」、導入済みには「インストール済み」タグが付く。生成ペットはカードのホバーで名前変更・エクスポート・削除できる。
• サイズ: オン時に表示されるスライダー。浮遊マスコットの大きさを全画面へ即時反映する。Alt+ホイールでもサイズを変更できる。
• 散歩: オン時に表示されるトグル。アイドル中にペットがウィンドウ内を歩き回る。

Cmd+K パレットとポップアウト

• Cmd+K →「ペット…」: キーボードだけでギャラリーの検索・採用・切り替えができる（テーマピッカーと同様）。
• Shift+クリック: 浮遊ペットを独立した透明・常時最前面のウィンドウへポップアウトする。Hermes を最小化してもペットが見え続ける。ポップアウト中のジェスチャは次のとおり。

ジェスチャ	動作
ドラッグ	画面上の任意の位置へ移動（アプリ外も可）。位置は再起動後も保持する
シングルクリック	直近セッションへ送るミニコンポーザーを開く
ダブルクリック	アプリウィンドウの最小化・復帰を切り替える
Shift+クリック	ペットをウィンドウ内へ戻す
メールアイコン	離席中にターンが完了したときだけ表示。クリックで最新スレッドを開く

ポップアウト中のペットだけが吹き出し（working…、thinking…、your turn など）を表示する。ウィンドウ内ではアプリ自体が主役なので、ペットは静かなまま。

保存とプロファイル

設定は config.yaml の display.pet 配下に保存される（シークレットや環境変数ではない）。ペットはプロファイル単位（<HERMES_HOME>/pets/）で管理され、プロファイルごとに別のペットを保持する。

キー	内容	既定
display.pet.enabled	マスターのオン/オフ	false
display.pet.slug	アクティブなペット（空は先頭）	""
display.pet.render_mode	端末レンダリング（auto / kitty / iterm / sixel / unicode / off）	auto
display.pet.scale	サイズ（ネイティブ 192×208 フレーム基準）	0.33
display.pet.unicode_cols	端末幅の固定上書き（0 は scale から算出）	0

render_mode と unicode_cols は CLI・TUI の端末描画向けの項目で、デスクトップの外観設定 UI では有効化・ペット選択・サイズ・散歩の4つを操作する。

このうち散歩（roam）だけは config.yaml ではなく、デスクトップの localStorage（hermes.desktop.pet-roam.v1、既定オフ）にデバイス単位で保存される。ドラッグ位置などと同じ端末ローカルの設定で、config.yaml を検索しても見つからない。サイズ（display.pet.scale）の画面表示はパーセント（初期値 33%）で、config.yaml に保存された値がそのまま反映される。

再起動が必要な場合

ペット機能が追加される前に起動したアプリが動作中だと、外観ページに「ペット機能には再起動が必要です」と表示される。Hermes を終了して開き直す。

ペットの生成（/hatch）、CLI の hermes pets コマンド、/pet スラッシュコマンドは スラッシュコマンド一覧 を参照。