Codex ペット

この PC に「Codex ペット」をインストールし、動作を検証してください。
プロジェクトのリポジトリ：https://github.com/itopinion/zectrix-agent-pet
インストール説明：https://github.com/itopinion/zectrix-agent-pet/blob/main/README.md
情報確認日：2026-10-17、参照コミット：2c9213dda1063f6f8a19a4470eed0b367d14b6ef。実行前に現行バージョンを再確認してください。
必要環境：OS に合わせてビルド · Hub Runtime API v1 · 対応ファームウェア
配布状況：ソースからビルド · OS ごとに対応
アプリのソースは公開されています。Hub は正式リリース前のため、リポジトリと同梱デバイス SDK は非公開です。
共通デバイス SDK ソース：https://github.com/itopinion/zectrix-hub/tree/main/crates/zectrix-cards/vendor/sdk（現在は非公開リポジトリにあり、アクセス権が必要です）。
クロスプラットフォーム移植ガイド：https://github.com/itopinion/zectrix-hub/blob/main/docs/PORTING.md。現行 SDK とデバイスファームウェアの対応関係を確認し、古いドキュメントのバージョンをそのまま適用しないでください。
まず OS、CPU アーキテクチャ、ビルドツールを確認してください。プロジェクトのソースと対応 SDK を使って現行 OS 向けにビルドし、ビルド済み Mac アプリを取得・配布しないでください。Python プロジェクトは対象 OS に独立した実行環境を作成してください。

共通の接続アシスタントを準備してからアプリをインストール：
1. この PC に ZECTRIX Hub（https://github.com/itopinion/zectrix-hub）があるか、動作状態、バージョン、アプリ用インターフェースを確認してください。互換性のある既存バージョンを再利用し、重複インストール、既存アプリ・設定・データの上書き、別接続によるデバイスの占有を避けてください。
2. Hub がない場合は、先に Hub と対応 SDK のソースへのアクセス権を確認してください。Hub は正式リリース前で、リポジトリは非公開です。権限がなければ必要な依存ソースを取得できないことを説明し、デバイスへの導入を保留してください。チャットでトークンを求めたり、リポジトリの公開範囲を変更したりしないでください。
3. 既存 Hub に互換性がない場合は、差分と更新方法を説明し、既存データを保持してください。Hub 内蔵 SDK とデバイスのファームウェアが対応するバージョンか照合してください。古い README の最低バージョンだけで互換性を判断せず、ファームウェアを自動で書き換えないでください。NOTE4C はこのアプリの対象外です。
4. NOTE4 と PC を同じ LAN に接続し、ローカル送信モードにしてください。Hub がデバイスを検出・選択し、接続を保持します。この手順では ZECTRIX Cloud API Key や事前の MAC 手入力は不要です。

このプロジェクトのインストールと使用手順：
1. システムと接続ヘルパーを確認：AI に OS とプロセッサーを確認してもらい、互換性のある既存 Hub を再利用します。ない場合は Hub と対応 SDK のソースへのアクセス権を確認してから、この OS 向けにビルドします。権限がなければデバイスへの導入を保留します。SDK と NOTE4 ファームウェアの対応を確認し、既存のアプリとデータを保持します。
2. ペットアプリをソースからビルド：公開リポジトリからソースを取得し、AI にこの OS 向けのビルド、Runtime API v1 の確認、Hub への接続を依頼します。ローカル Codex のパス、プロセス、状態の取得方法を確認し、別の OS では必要な移植を行います。
3. ローカル Codex の追従を確認：新規インストールではローカル Codex の追従が初期設定で有効になり、更新時は既存の設定を保持します。追従設定を確認し、テストタスクで作業中・待機中・完了の状態を確認します。必要に応じてアニメーションと音量を調整し、対応が必要な場合は該当 Agent のウィンドウに戻ります。
アプリは Hub Runtime API を使い、デバイス SDK は接続層が使用します。SDK の取得だけで Hub の代わりにはなりません。OS ごとのパス、プロセス管理、ビルド依存関係、音声バックエンドを確認し、必要に応じて移植してください。ビルド成功はクロスプラットフォーム機能の検証完了を意味しません。

初回検証：テストと明示したタスクで作業中・待機中・完了を検証し、ページ送りと通知音を確認してください。デモ状態を実際のタスク進捗として扱わないでください。
プログラム起動、画像生成、デバイス受信、実画面の確認を分けて報告し、シミュレーション成功を実機検証と扱わないでください。インストール場所、再起動・停止方法、PC やネットワーク切断時の制限も説明してください。
キー、Hub 認証情報、アカウント、個人データはローカルだけで設定し、共有タスクやログに含めないでください。AI にローカル実行環境がなければ、確認可能なローカルインストール手順を提示し、インストール済みと報告しないでください。