petdex

Petdex スキル

公開されているpetdexギャラリーから、アニメーションする「ペット」マスコットを閲覧、インストール、選択できます。インストールしたペットは、Hermes CLI、TUI、デスクトップアプリでエージェントのアクティビティ（アイドル中、ツール実行中、レビュー中、エラー、完了）に反応します。このスキルは hermes pets CLI と display.pet 設定を操作するものであり、スプライトは生成しません。

使用する場面

• ユーザーがデスクトップまたはターミナルのマスコットを求めている場合、または「ペット」や petdex について尋ねている場合。
• ユーザーがアクティブなペットの変更、プレビュー、無効化を希望している場合。
• ペットが表示されない理由（ターミナルのグラフィックス対応、設定）を診断する場合。

前提条件

• ギャラリー／マニフェストへのアクセスに petdex.dev のネットワーク接続が必要です（読み取り専用、認証不要）。
• スプライトのデコードに Pillow（Hermes のコア依存関係）が必要です。すでにインストールされています。
• ターミナルで忠実度の高い描画を行うには、グラフィックス対応ターミナル（kitty、Ghostty、WezTerm、iTerm2、または sixel）が必要です。それ以外の場合は、truecolor の Unicode 半ブロックによる代替表示が自動的に使用されます。

実行方法

terminal ツールを使って hermes pets <subcommand> を実行します。

クイックリファレンス

目的	コマンド
ギャラリーを閲覧する	hermes pets list（フィルターするには部分文字列を追加します：hermes pets list cat）
インストール済みのペットを一覧表示する	hermes pets list --installed
ペットをインストールする	hermes pets install <slug>（アクティブにするには --select を追加します）
アクティブなペットを設定する	hermes pets select <slug>（選択画面を表示するには slug を省略します）
ペットのサイズを全体で変更する	hermes pets scale <factor>（例：0.5。範囲は 0.1～3.0 に制限されます）
ターミナルでプレビュー／アニメーションを表示する	hermes pets show [slug] [--cycle] [--state run]
ペットを無効にする	hermes pets off
ペットを削除する	hermes pets remove <slug>
セットアップを診断する	hermes pets doctor

手順

1. ペットを探します：hermes pets list <query> を実行し、その slug を控えます。
2. インストールして有効化します：hermes pets install <slug> --select を実行します。
3. プレビューします：hermes pets show を実行します（停止するには Ctrl+C を押します）。
4. セットアップを確認します：hermes pets doctor を実行すると、解決されたペット、設定された描画モード、検出されたターミナルのグラフィックスプロトコル、有効なモードが表示されます。

ペットは <HERMES_HOME>/pets/<slug>/ にインストールされます（プロファイルに対応）。ペットを選択すると、display.pet.slug と display.pet.enabled が config.yaml に書き込まれます。

設定

config.yaml の display.pet の下に設定します。

• enabled（bool）— 全体のオン／オフ設定です。
• slug（str）— アクティブなペットです。空の場合は、最初にインストールされたペットが使われます。
• render_mode — auto（検出） | kitty | iterm | sixel | unicode | off。
• scale（float）— ネイティブの 192×208 フレームの画面上のサイズです（デフォルトは 0.33、範囲は 0.1～3.0 に制限されます）。この設定ひとつで、すべての表示面のサイズが変わります。hermes pets scale <factor>、/pet scale スラッシュコマンド、またはデスクトップの「外観」スライダーで設定します。
• unicode_cols（int）— Unicode 代替表示の列幅です。

注意点

• ペットを表示するには、インストールに加えて選択も必要です（enabled: true）。
• パイプ／リダイレクト内（TTY がない場合）では、仕様によりターミナル描画は無効になります。
• petdex の npm CLI は ~/.codex/pets にインストールしますが、Hermes はプロファイルごとの独自の <HERMES_HOME>/pets/ を使います。hermes pets からインストールしてください。

検証

• ペットがインストール済み、選択済み、有効で、Pillow をインポートできる場合、hermes pets doctor は ✓ ready を報告します。