quest-tooling

Quest ツールチェーン：1 つの CLI、2 つのインターフェース、エージェントごとに 1 つのチャネル

metavr（Meta VR CLI）は、コマンドラインと、エージェントが自ら操作する stdio MCP サーバーという 2 つの顔を持つ単一のツールです。以下の機能はどちらからも利用できます。CLI のコマンド名を記載しているのは、MCP サーバーが設定されていない場合の代替手段でもあるためです。

調査を計画する場合、キャプチャ／自動化の方法を選ぶ場合、情報源の矛盾に対処する場合、またはツールなしで作業する場合は、references/research-navigation.md を読んでください。この日付付きコマンドマップを使う前に、実行ファイルを特定し、そのバージョンのヘルプを確認してください。生成された関連手順書には、異なるバージョンの説明が記載されている場合があります。

製品全体のロードマップやステージ監査には quest-lifecycle を使ってください。単一の技術タスクは、引き続きこの担当に任せてください。利用できない場合は、現在のステージ、その根拠、次の前提条件をインラインで示してください。

現在の情報源の発見、利用できない Markdown、要件の矛盾、バージョン管理された API インデックス、既存の CLI／MCP 登録については、references/source-research.md を読んでください。

1 つのチャネルから一度だけインストールする

チャネル	コマンド	更新
ネイティブインストーラー（推奨）	curl -fsSL https://developers.meta.com/horizon/install-cli/ | sh → ~/.metavr/bin	metavr update でインストール先を更新
npx（インストール不要）	npx -y metavr@latest <cmd>	常に最新
npm グローバル	npm install -g metavr	単独では更新されません — npm update -g metavr が必要です

2 つの方法で同時にインストールすると、バージョンの不一致がバグと誤認される原因になります。この環境では、~/.metavr/bin/metavr（1.3.2.2.2）と /opt/homebrew/bin/metavr（npm 1.3.2）の両方が metavr として実行され、どちらが使われるかは PATH の順序で決まりました。which -a metavr で確認し、1 つだけ残してください。

metavr auth login でサインインし、metavr auth status で確認してください。サインインすると Store コマンドが使えるようになります。無人の自動化では METAVR_TOKEN を利用できます。

metavr init はセットアップではなく罠です

init はスキルをインストールし、MCP サーバーを設定し、エージェントのプラグインをインストールします。対象を指定するフラグがない場合は --all-agents を意味し、「すべてのエージェント」は固定リストであり、実際に利用しているエージェントを指すものではありません。プロジェクトディレクトリ内で実行すると、エージェントごとに 1 つの skills/ ツリーをそのディレクトリ内に作成します。

ゲームリポジトリで 2026-09-20 に計測したところ、スキル 29 個 × ディレクトリ 25 個 = 4129 個のファイル、47 MB となりました。これらは追跡対象外で、.gitignore にも含まれていませんでした。そして次の git add -A で、そのすべてが製品にコミットされました。

この環境では、セットアップの前にゲートウェイ／プラグインの登録を確認してください。新しいスタンドアロンの metavr stdio サーバーはゲートウェイに登録します。metavr mcp install の例はエージェントを直接設定するものであり、ここでの既定の方法ではありません。選択したホストへのインストールが必要な場合は、まず metavr init --help と対象パスを確認してください。プロジェクトが所有する .agents やその他の既存ファイルを広範囲に無視しないでください。

コマンド一覧

作業	コマンド
接続されているデバイスを確認する	metavr device list / device info <id> / device battery
Wi-Fi 経由でペアリングする	metavr device connect（先に USB 接続）、device wait、device health-check
デバイスをテストで安定して使えるようにする	metavr device configure-testing（アニメーションをオフにし、スリープしないようにする）
ビルドをインストール／起動／停止する	metavr app install <apk> / app launch <pkg> / app stop <pkg>
ログ	metavr log（logcat）、metavr shell <cmd>
画面	metavr capture screenshot
デバイス上のファイル	metavr files push / pull / ls / rm
UI の自動化	metavr ui dump / tap / type / swipe / wait
パフォーマンス	metavr perf capture / start / stop / analyze-trace / compare / simpleperf
ドキュメントと API リファレンス	metavr docs search / fetch / api-search
3D アセット	metavr asset search "<thing>"
ストアでの配布	metavr store dist apps / channels / upload / copy-build、store test-user
エミュレーター	metavr ssim（SpatialSim）
管理対象ツール	metavr tools list / install <name>
セットアップレポート	metavr doctor

metavr doctor が報告するのはインストール済みソフトウェアのみです。デバイスへの接続、サインイン、MCP の接続設定はテストしません。ヘッドセットが接続されていない状態で doctor の表示が緑でも、何も実行できないマシンであることに変わりはありません。

MCP サーバーと二重に登録される仕組み

metavr mcp server は stdio サーバーです。Meta のプラグインが登録を管理する場合もあれば、そうでない場合はオペレーターが設定したゲートウェイで公開できます。両方を登録しないでください。この環境では、新しいスタンドアロンの stdio／静的トークンサーバーは ~/.config/agentgateway/servers.yaml と既存の生成／移行フローを通じて登録します。OAuth 保護リソースサーバーはエージェント側に配置します。プラグインが管理する MCP はプラグイン側に置きます。直接 .mcp.json を使うのは、選択したデプロイポリシーで指定されている場合に限ります。あらゆるプロジェクトに適用できるセットアップ手順ではありません。

metavr xroperator status では、XR Operator プロキシがインストールされ、metavr 独自の MCP サーバーにフェデレーションされているかを確認できます。フェデレーションされていれば、実行中の XR アプリを同じ接続経由で調査できます。2つ目のサーバーを登録する必要はありません。

Meta の 29 個のスキルと、このパックで追加される内容

Meta はこれらを github.com/meta-quest/agentic-tools で公開しています（プラグイン meta-vr@meta-quest。npx skills、gh skill、Cursor、Codex、Gemini からも利用できます）。どのスキルを使うべきか迷う前に、次の分類を把握しておくと便利です。

Meta のスキル	数	担当領域
hz-unity-*	12	Unity — このパックでは重複して提供しません
hz-quest-verify-first、metavr-cli、portal	3	ドキュメントの検証と CLI リファレンス
hz-perfetto-debug、hz-simpleperf-debug、hz-vr-debug	3	特定のプロファイラーの操作
hz-store-submit、hz-store-pwa	2	ストア関連の手順
hz-spatial-sdk、hz-iwsdk-webxr、hz-android-2d-porting、hz-platform-sdk、hz-psdk-integration、その他	9	その他のビルド経路

このパックでは、ツールの上位にある疑問に答えます。プロジェクトがどの経路を使うのか、どの数値を読むのか、何を測定するのか、ストアで何が却下されるのか、といった疑問です。Meta のスキルがツールを操作する場合は、そのスキルを使い、どのスキルが作業を行ったかを明記してください。

デスクにヘッドセットがない場合

• xrsim（Meta XR Simulator）と spatialsim（metavr ssim）は、マシン上でアプリのロジックを実行します。サポート対象のシミュレーション動作と統合を確認できます。
• パフォーマンスに関する疑問には答えられません。実際の GPU も、熱特性も、コンポジターもないためです。quest-perf を参照してください。
• metavr device browser <url> とストアのテストアカウント（metavr store test-user）には、実機と組織が必要です。

管理対象の開発者ツール

metavr tools install <name> で取得してインストールし、metavr tools list でバージョンとインストール済みツールを確認できます。ヘッドセットが必要かどうかも含め、各ツールの用途については references/tool-matrix.md を参照してください。

後で運用コストを払うことになるため、整理整頓が大切です

1. エージェントごとにチャネルを1つにします。 ~/.claude/skills/<name> に通常のコピーを置けば、同名のプラグインより優先され、固定されたバージョンをいつまでも利用できます。
2. スキルを製品リポジトリに取り込まないでください。 スキルはマシンにインストールするものです。リポジトリにコピーすると、サードパーティーのテキスト47 MBが追加され、CIの lint 対象になってしまいます。
3. スキルとプラグインはセッション開始時に読み込まれます。どちらかを変更した後はエージェントを再起動してください。そうしないと、古いセットが使われ続けます。
4. インストールまたは削除の後、何も出力されないことを確認するコマンド：

for d in ~/.claude/skills/*/; do n=$(basename "$d"); \
  [ -e ~/.claude/plugins/marketplaces/"$n" ] && echo "SHADOW: $n"; done

CLI の概要は、2026-09-20 に 1.3.2.2.2 の metavr --help から取得しました。インストールと初期化の動作は、同日にこのマシンで確認しました。

トリガー

ここに誘導するその他のフレーズ：「Quest に adb」／「ヘッドセットに adb」、「XR Simulator」／「シミュレーター」、「ヘッドセットなし」／「ヘッドセットがない」、「metavr init」、「Meta VR CLI」、「Quest MCP」／「Quest 用 MCP」、「APK をインストール」／「ヘッドセットに apk をインストール」、「開発者モード」／「開発者モード」、「インストール済みの Quest ツールはどれ」／「Quest 用に何がインストールされているか」、「hz- skills」／「Meta のスキル」。

0.4.4 で説明からここに移動：「ヘッドセットを接続」。

0.4.5 で追加された、ヘッドセット名を含む修飾形（ハブ B-298）：「Meta XR Simulator」／「Quest シミュレーター」、「Quest に APK をインストール」／「Quest に apk をインストール」、「Quest の開発者モード」／「Quest の開発者モード」。