Skip to content
Back to search

agentic-tools

Agent Skills for Meta Quest/Horizon OS VR Development

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/meta-quest--agentic-tools/badge.svg)](/listings/meta-quest--agentic-tools)

HTML

<a href="/listings/meta-quest--agentic-tools"><img src="/api/listings/meta-quest--agentic-tools/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Standalone binary

Install the standalone binary on your PATH (no prerequisites):

# macOS and Linux
curl -fsSL https://developers.meta.com/horizon/install-cli/ | sh
# Windows (PowerShell)
iwr -useb https://developers.meta.com/horizon/install-cli/windows/ | iex

The installer adds `metavr` to your PATH (source your shell rc or open a new terminal to pick it up). If you installed the standalone binary, keep it current with `metavr update`.

npm distribution

The npm distribution requires Node.js 16 or newer, and needs no install of its own:

npx -y metavr --version

With [Bun](https://bun.sh), substitute `bunx metavr` for `npx -y metavr` (no `-y` needed).

Commands in this README use the bare `metavr` form. If you use the npm distribution, prefix with `npx -y`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "meta-vr",
  3. "owner": {
  4. "name": "Meta Platforms, Inc."
  5. },
  6. "plugins": [
  7. {
  8. "name": "meta-vr",
  9. "description": "Agent skills for Meta VR and Horizon OS development. Helps your coding agent with Meta VR app debugging, performance analysis, project setup, Unity and WebXR workflows, Spatial SDK and Platform SDK integration, store submission checks, and metavr device workflows.",
  10. "version": "2.0.0",
  11. "author": {
  12. "name": "Meta Platforms, Inc."
  13. },
  14. "homepage": "https://developers.meta.com/horizon/discover/ai-tools/",
  15. "source": "./",
  16. "keywords": ["meta-quest", "horizon-os", "meta-vr", "vr", "xr", "mixed-reality", "unity", "webxr", "spatial-sdk", "platform-sdk", "android", "metavr", "debugging", "performance", "openxr", "meta"]
  17. }
  18. ]
  19. }
README.md · README · 344 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Meta VR Agentic Tools
  2. [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
  3. [![Meta VR](https://img.shields.io/badge/Meta_VR-Developer-1877F2)](https://developers.meta.com/horizon/)
  4. Agentic skills and tools for Meta VR and Horizon OS development.
  5. ## What is this?
  6. This repository packages a curated set of agentic tools and skills for Meta VR and Horizon OS development, along with shared `metavr` references and contribution/process documentation for maintaining the skill ecosystem.
  7. The skills follow the open Agent Skills model: each skill has a required `SKILL.md` plus optional supporting files that are loaded on demand. This repo includes packaging artifacts for Claude Code, Cursor, Codex, GitHub Copilot CLI, and Gemini-compatible environments.
  8. Skills are powered by the **metavr** (Meta VR CLI), which provides device management, app management, performance tooling, and documentation search through both direct commands and an MCP server.
  9. ## Prerequisites
  10. - **metavr CLI**: install it natively or invoke via `npx` with no install (see [Install the metavr CLI](#install-the-metavr-cli))
  11. - **Meta VR device** with [Developer Mode](https://developers.meta.com/horizon/documentation/native/android/mobile-device-setup/) enabled (for on-device skills)
  12. ## Install the metavr CLI
  13. ### Standalone binary
  14. Install the standalone binary on your PATH (no prerequisites):
  15. ```bash
  16. # macOS and Linux
  17. curl -fsSL https://developers.meta.com/horizon/install-cli/ | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 29 on GitHub
  18. ```
  19. ```powershell
  20. # Windows (PowerShell)
  21. iwr -useb https://developers.meta.com/horizon/install-cli/windows/ | iex
  22. ```
  23. The installer adds `metavr` to your PATH (source your shell rc or open a new terminal to pick it up). If you installed the standalone binary, keep it current with `metavr update`.
  24. ### npm distribution
  25. The npm distribution requires Node.js 16 or newer, and needs no install of its own:
  26. ```bash
  27. npx -y metavr --version
  28. ```
  29. With [Bun](https://bun.sh), substitute `bunx metavr` for `npx -y metavr` (no `-y` needed).
  30. Commands in this README use the bare `metavr` form. If you use the npm distribution, prefix with `npx -y`.
  31. ## Installation
  32. ### Muse Code
  33. The fastest path on any agent is `metavr init`: it detects your installed agents and sets up these skills plus the metavr MCP server (Muse Code is configured first):
  34. ```bash
  35. metavr init
  36. ```
  37. Prefer the plugin route instead:
  38. ```bash
  39. muse plugins marketplace add meta-vr meta-quest/agentic-tools
  40. muse plugins install meta-vr@meta-vr
  41. ```
  42. ### Claude Code
  43. Add Meta VR Agentic Tools marketplace and install the agentic tools plugin
  44. Within claude run:
  45. ```
  46. /plugin marketplace add meta-quest/agentic-tools
  47. /plugin install meta-vr@meta-vr
  48. ```
  49. ### Cursor
  50. Install from the [Cursor marketplace](https://cursor.com/marketplace/meta-reality-labs) with:
  51. ```
  52. /add-plugin meta-quest-agentic-tools
  53. ```
  54. Or install online at: https://cursor.com/marketplace/meta-reality-labs
  55. ### Codex
  56. ```bash
  57. codex plugin marketplace add meta-quest/agentic-tools
  58. codex plugin add meta-vr
  59. ```
  60. ### GitHub Copilot CLI
  61. ```bash
  62. copilot plugin marketplace add meta-quest/agentic-tools
  63. copilot plugin install meta-vr@meta-quest
  64. ```
  65. ### Gemini
  66. ```bash
  67. gemini extensions install https://github.com/meta-quest/agentic-tools
  68. ```
  69. ## Install with a skills CLI
  70. ### Direct install
  71. These editor-agnostic CLIs install the skills from this repo into whichever agent you choose, independent of any editor or plugin marketplace.
  72. ### Agent Skills CLI (`gh skill`)
  73. Published as [Agent Skills](https://agentskills.io) releases and installable with the built-in `gh skill` command. Requires a recent [GitHub CLI](https://cli.github.com) (`gh`) — `gh skill` is a preview feature.
  74. ```bash
  75. # Install all skills from this repo
  76. gh skill install meta-quest/agentic-tools
  77. # Install a single skill
  78. gh skill install meta-quest/agentic-tools hz-spatial-sdk
  79. # Target a specific agent, or install for all projects
  80. gh skill install meta-quest/agentic-tools --agent claude-code --scope user
  81. ```
  82. ### skills.sh (`npx skills`)
  83. ```bash
  84. # Add every skill from this repo
  85. npx skills add meta-quest/agentic-tools
  86. ```
  87. Browse the catalog at [skills.sh/meta-quest/agentic-tools](https://skills.sh/meta-quest/agentic-tools).
  88. ### Context7 (`npx ctx7`)
  89. ```bash
  90. # Interactive — pick from a list
  91. npx ctx7@latest skills install /meta-quest/agentic-tools
  92. # Install a specific skill, or everything
  93. npx ctx7@latest skills install /meta-quest/agentic-tools hz-spatial-sdk
  94. npx ctx7@latest skills install /meta-quest/agentic-tools --all
  95. # Target a specific IDE: --claude, --cursor, --universal (.agents/skills/), or --global
  96. npx ctx7@latest skills install /meta-quest/agentic-tools --all --claude
  97. ```
  98. ## MCP Server
  99. metavr includes a built-in [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server with 40+ tools for device management, app control, file operations, documentation search, performance tracing, and more. This lets AI coding assistants interact directly with your Meta VR device.
  100. ### Install the MCP server into your AI tool
  101. > If you use the npm distribution instead of the standalone binary, prefix every command below with `npx -y` (or `bunx` for [Bun](https://bun.sh) users; no `-y` needed).
  102. ```bash
  103. # Muse Code
  104. metavr mcp install muse-code
  105. # Claude Code
  106. metavr mcp install claude-code
  107. # Claude Desktop
  108. metavr mcp install claude-desktop
  109. # Cursor
  110. metavr mcp install cursor
  111. # VS Code / VS Code Insiders
  112. metavr mcp install vscode
  113. metavr mcp install vscode-insiders
  114. # Windsurf
  115. metavr mcp install windsurf
  116. # Zed
  117. metavr mcp install zed
  118. # Android Studio (Gemini)
  119. metavr mcp install android-studio
  120. # Gemini CLI
  121. metavr mcp install gemini-cli
  122. # OpenAI Codex CLI
  123. metavr mcp install codex
  124. # LM Studio
  125. metavr mcp install lm-studio
  126. # OpenCode
  127. metavr mcp install open-code
  128. # Google Antigravity (Gemini)
  129. metavr mcp install antigravity
  130. # Generic project-local config
  131. metavr mcp install project
  132. ```
  133. Or start the MCP server directly:
  134. ```bash
  135. metavr mcp server
  136. ```
  137. ## Skills
  138. <!-- BEGIN GENERATED: skills-table (managed by tools/export_skills.py) -->
  139. | Skill | Description |
  140. |-------|-------------|
  141. | `metavr-cli` | Provides the complete metavr (Meta VR CLI) reference for Meta VR and Horizon OS development — installation, device setup, command discovery, MCP server mode, documentation search, app deployment, device testing setup, audio control, screenshots, and performance analysis. Use when the user needs to install metavr, asks what commands are available, needs CLI syntax help, or wants to know what metavr can do. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear. |
  142. | `hz-android-2d-porting` | Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design requirements. Use when adapting a mobile Android app for Meta VR. For UI design decisions, use hz-panel-designer if available. Build path: Standard Android; use hz-quest-verify-first if the build path is unclear. |
  143. | `hz-api-upgrade` | Upgrades Meta VR apps to newer Horizon OS SDK versions — migration guides, deprecated API replacements, changelog. Use when updating SDK versions or fixing deprecated API warnings. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear. |
  144. | `hz-unity-sdk-upgrade` | Upgrades Unity projects between Meta XR SDK versions for Meta VR and Horizon OS. Use when moving from Oculus Integration or older com.meta.xr packages, resolving post-upgrade compile errors, or validating runtime behavior. Grounds migration decisions in current metavr documentation results and records coverage gaps instead of relying on static summaries. Do not use for Unreal, native Android, Spatial SDK, or WebXR upgrades. |
  145. | `hz-immersive-designer` | Guides design of comfortable, intuitive VR/MR experiences for Meta VR and Horizon OS — comfort guidelines, interaction patterns, spatial layout, accessibility. Use during UX design review or when evaluating comfort and accessibility. Build paths: Meta Spatial SDK, Unity, Unreal, native OpenXR, and WebXR; for 2D panel apps use hz-panel-designer if available. Use hz-quest-verify-first if the build path is unclear. |
  146. | `hz-iwsdk-webxr` | Builds WebXR experiences for Meta VR and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js integration, spatial UI. Use when creating web-based VR/MR apps for Quest Browser. |
  147. | `hz-metavrx-layout-sdk` | Build multi-window Meta Horizon OS experiences with the MetaVrx Layout SDK in Jetpack Compose or React Native. Covers framework selection, setup, anchoring, semantic offsets, window promotion, fallback, priority, lifecycle, and theming. Use for apps that need multiple app-owned panels without an immersive scene. Build path: Standard Android, including React Native; use hz-quest-verify-first if the path is unclear, and do not use this skill for immersive Spatial SDK scenes. |
  148. | `hz-metavrx-ui-set` | Builds app UI for Meta VR and Horizon OS with the MetaVrx UI Set, a Jetpack Compose component library and design system. Covers UiSetTheme, buttons, cards, controls, dialogs, dropdowns, inputs, side navigation, sliders, tooltips, the Icons.Regular library, Gradle setup, and migration from the Spatial SDK UI Set. Build path: Standard Android; use hz-quest-verify-first if the path is unclear. |
  149. | `hz-new-project-creation` | Scaffolds new Meta VR and Horizon OS projects after the build path is selected — Standard Android, Meta Spatial SDK, Unity, Unreal, or WebXR. Use when creating a new Meta VR app from scratch. Build paths: all; use hz-quest-verify-first to choose the path. |
  150. | `hz-perfetto-debug` | Analyzes Meta VR and Horizon OS VR performance using Perfetto traces — frame timing, CPU/GPU bottlenecks, render pass analysis. Use when profiling frame drops, jank, or thermal issues on Meta VR devices. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear. |
  151. | `hz-platform-sdk` | Guides integration of the Horizon Platform SDK for Meta VR and Horizon OS Android/Kotlin apps — achievements, IAP, users, leaderboards, presence, notifications, abuse reporting, entitlements, asset files, application lifecycle, consent, device integrity, language packs, user age categories, and rate and review. Covers setup, initialization, API usage, data types, error handling, and best practices for all 17 public platform SDK packages. Build paths: Standard Android and Meta Spatial SDK; use hz-psdk-integration for guided integration, hz-unity-platform-sdk for Unity/C#, and hz-quest-verify-first if the path is unclear. |
  152. | `hz-psdk-integration` | Guides interactive Horizon Platform SDK (PSDK) integration for Meta VR and Horizon OS Android/Kotlin apps — analyzes the codebase, recommends public platform features, plans the integration, and validates on device. Use for workflow guidance; use hz-platform-sdk for the detailed API reference. Build paths: Standard Android and Meta Spatial SDK; use hz-quest-verify-first if the path is unclear. |
  153. | `hz-quest-verify-first` | MANDATORY pre-flight check before answering any question or writing any code related to Meta Quest VR headsets (Quest 2, Quest 3, Quest 3S, Quest Pro) or apps that target them. Forces verification against authoritative Meta sources via the metavr CLI / metavr MCP tools BEFORE relying on training-data knowledge. Counters the failure mode where agents answer Quest-related questions from stale memory and ship deprecated APIs, broken Android manifests, and store-rejected builds. Loads automatically when the user is in a Quest project (any reference to Oculus / Meta Quest / Horizon OS, Unity OVR or Meta XR packages, com.meta.* / com.oculus.* package IDs, Quest-targeted AndroidManifest, .meta files, or developers.meta.com / developer.oculus.com URLs). Build paths: all; use this skill first whenever the path is unknown or a Quest-specific claim is involved. |
  154. | `hz-simpleperf-debug` | Profiles Meta VR and Horizon OS application CPU performance using simpleperf — workload classification, CPU hotspot recording, kernel overhead measurement. Use when diagnosing whether an app is CPU-bound, memory-bound, or I/O-bound on Meta VR devices. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear. |
  155. | `hz-spatial-sdk` | Builds spatial Android apps for Meta VR and Horizon OS with Meta Spatial SDK — ECS architecture, 2D panels, 3D objects, hybrid experiences. Use when creating Kotlin-based spatial applications. Build path: Meta Spatial SDK; use hz-quest-verify-first if the build path is unclear. |
  156. | `hz-store-pwa` | Guides shipping a web app to the Meta VR and Horizon OS Store as a PWA/TWA — both 2D windowed panels and immersive WebXR/VR. Covers building the web app (IWSDK for WebXR, any responsive PWA for 2D), Vercel deploy, web app manifest + icons, the WebXR-only auto-enter-session step, choosing 2D vs immersive mode in @meta-quest/bubblewrap-cli, keystore/Digital-Asset-Links, and ovr-platform-util Store upload. Use before any IWSDK/WebXR build, PWA packaging, bubblewrap, or Horizon Store upload work. |
  157. | `hz-store-submit` | Guides end-to-end Meta VR and Horizon OS app submission to the Meta Horizon Store — build validation, store-readiness checks, asset preparation, upload, and submission tracking. Use when preparing a Meta VR app for store publishing. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear. |
  158. | `hz-unity-code-review` | Reviews Unity code targeting Meta VR and Horizon OS for performance issues, rendering best practices, and common VR pitfalls. Use during code review or when diagnosing Meta VR performance problems in Unity projects. |
  159. | `hz-unity-face-tracking` | Drive ARKit-blendshape-rigged head/face models in Unity with the wearer's facial expressions on Meta VR via Meta Movement SDK (face tracking + A2E). Use when a user has an FBX with the 52 ARKit blendshapes (any prefix, _L/_R suffixes) and wants it to animate from face tracking on Quest Pro / Quest 3 / Quest 3S. |
  160. | `hz-unity-fbx-import` | Ensures complete FBX URLs or absolute paths are used when importing external 3D models into Unity projects targeting Meta VR and Horizon OS. Use when adding FBX files, 3D models, or external assets. |
  161. | `hz-unity-meta-core-sdk` | Meta XR Core SDK (com.meta.xr.sdk.core) for Unity XR development. Use when setting up VR/MR projects, configuring OVRManager, adding OVRCameraRig, enabling passthrough, hand tracking, spatial anchors, boundaryless mode, controller input, Scene API, or any Meta VR feature. Covers OVRProjectSetup, AndroidManifest generation, and project configuration for Meta VR devices, driven against a live Editor with unity-cli. |
  162. | `hz-unity-meta-mixed-reality-utility-kit` | Meta XR Mixed Reality Utility Kit (MRUK) (com.meta.xr.mrutilitykit) for Unity XR development. Use when working with Scene API data (rooms, walls, floors, furniture), spawning prefabs on scene anchors, placing virtual objects in the real world, world locking to prevent anchor drift, raycasting against room geometry, generating NavMesh from scene data, environment depth raycasting for instant placement without scanning, Passthrough Camera Access (PCA), trackable detection (keyboards, QR codes), destructible scene meshes, space maps, room sharing for multiplayer, or any MR scene-aware feature. |
  163. | `hz-unity-meta-movement-sdk-retargeting` | Set up and tweak Meta Movement SDK (MSDK) retargeting for a character model. Use this whenever the user wants to retarget a humanoid FBX/prefab for Meta VR body tracking, generate a retargeting config, or hand-edit the resulting `<asset>.json` (fix known-joint mappings, exclude joints from auto-mapping, rename target joints, adjust per-joint mapping weights, change a mapping behavior to twist/childAlignedTwist, edit T-pose values). The headless entry point is `Meta.XR.Movement.Editor.MSDKUtilityEditor.RunDefaultRetargetingSetup(GameObject asset)` — call it against a live Editor with unity-cli first, then hand-edit if needed. **Skip** if the user is editing runtime retargeting code, the source `OVRSkeletonData.json`, or non-MSDK files. |
  164. | `hz-unity-meta-quest-ui` | Configures Unity UI for Meta VR and Horizon OS VR development — world-space canvases, TextMesh Pro setup, comfortable sizing, viewing distances, and interaction readiness. |
  165. | `hz-unity-passthrough-camera-access` | Meta Quest Passthrough Camera Access (PCA) for Unity — access the forward-facing RGB cameras on Quest 3 / Quest 3S to feed Computer Vision and Machine Learning pipelines. Use when capturing the passthrough camera image/texture, reading the camera pose and intrinsics, projecting camera pixels into world space via `PassthroughCameraAccess.ViewportPointToRay`, wiring camera frames into ML/CV models, or reasoning about resolution, permissions, vendor tags, and the pinhole/principal-point model. For projecting the image onto a flat world-space surface (frustum-slice quad / image-plane overlay) see references/principal-point-offset.md; for placing 2D ML detections as world-space 3D bounding boxes see references/detection-bounding-boxes.md. Skip if the user only wants to cast the user's POV (use the Media Projection API instead) or is doing screen-space-only overlays. |
  166. | `hz-unity-placement` | Ensures accurate object placement in Unity projects targeting Meta VR and Horizon OS by using Renderer and Collider bounds when objects are added, moved, or positioned relative to other objects. |
  167. | `hz-unity-platform-sdk` | Guides integration of the Horizon Platform SDK for Meta VR and Horizon OS Unity/C# apps — achievements, IAP, users, leaderboards, challenges, presence, notifications, abuse reporting, entitlements, asset files, application lifecycle, consent, device integrity, language packs, user age categories, and rate and review. Covers setup, initialization, API usage, data types, error handling, and best practices for all 18 public platform SDK packages. |
  168. | `hz-unity-project-analyzer` | Analyzes, documents, and maintains a living `.agent-docs/` knowledge base for Unity projects targeting Meta VR and Horizon OS. Use when the user asks to scan project structure, explain how a Unity system works, or update project docs after structural changes. |
  169. | `hz-unity-tmp-resources` | Imports and configures TextMesh Pro Essential Resources for Unity projects targeting Meta VR and Horizon OS. Use when setting up TMP UI, fixing missing TMP materials or fonts, or resolving pink/magenta TMP text. |
  170. | `hz-vr-debug` | Debugs Meta VR and Horizon OS VR, MR, and Android applications using the metavr CLI — view logs, capture screenshots, and diagnose common issues. Use when troubleshooting crashes, errors, or unexpected behavior on Meta VR devices. Build paths: All; use hz-quest-verify-first if the path is unclear. |
  171. | `hz-xr-simulator-control` | Routes Meta VR and Horizon OS simulator work to the right `metavr` command group, and drives a running Meta XR Simulator via `metavr xrsim` — runtime, device, input, compositor layers and MP4 recording. Use when a goal concerns a simulated headset rather than a physical one, when choosing between `xrsim`, `ssim`, `capture` and `tapedeck`, or when a `metavr xrsim` command returns a connection error. For installing the simulator or configuring it into a Unity, Unreal or native OpenXR project, use hz-xr-simulator-install-and-configure instead. |
  172. | `hz-xr-simulator-install-and-configure` | Installs and configures the Meta XR Simulator for testing Meta VR and Horizon OS apps without a physical device. Use when installing the simulator or integrating it with Unity, Unreal, or native OpenXR projects. For controlling a running simulator, use hz-xr-simulator-control. Build paths: Unity, Unreal, and native OpenXR; route Standard Android, Meta Spatial SDK, and WebXR work through hz-quest-verify-first. |
  173. | `portal` | Build and sideload Android apps for Meta Portal devices (Portal, Portal+, Portal Mini, Portal Go, Portal TV) using metavr. Use when targeting Portal hardware — covers ADB enablement, the no-GMS constraint, manifest/launcher intent-filter requirements, icon density quirks (PNG-only, mipmap-xxxhdpi), the Smart Camera SDK, and the gradle + `metavr adb` build/deploy/debug loop. Auto-load when the user mentions "Portal" device, targets `minSdkVersion` 28-29 for a tabletop/TV form factor, or works with the `com.facebook.portal` package. |
  174. | `hz-unity-device-readiness` | Audits a Unity project for Meta VR Glasses readiness across input and field of view — finds controller-dependent interactions such as OVRInput usage, recommends hand-tracking and ISDK controller-to-hands migrations, produces a prioritized migration plan, and detects head-locked UI that a narrower FoV would clip. |
  175. <!-- END GENERATED: skills-table -->
  176. ## metavr CLI quick reference
  177. metavr organizes commands into groups:
  178. | Command group | Purpose |
  179. |---------------|---------|
  180. | `metavr init` | Set up `metavr` — install AI agent skills and configure MCP servers |
  181. | `metavr auth` | Manage authentication (login, logout, status) |
  182. | `metavr adb` | Low-level ADB-compatible commands (devices, shell, logcat, etc.) |
  183. | `metavr app` | Manage applications on the device (install, uninstall, launch, etc.) |
  184. | `metavr asset` | Search Meta's 3D asset library for models |
  185. | `metavr audio` | Device audio volume and mute control |
  186. | `metavr capture` | Capture screenshots and screen recordings from the device |
  187. | `metavr casting` | Start or stop headset casting |
  188. | `metavr config` | Manage metavr configuration settings |
  189. | `metavr device` | List, connect, reboot, and query connected Meta VR devices |
  190. | `metavr store` | Meta Horizon Store operations — app distribution and test accounts |
  191. | `metavr docs` | Search Meta VR developer documentation |
  192. | `metavr doctor` | Review your developer setup and report detected software + paths |
  193. | `metavr files` | Manage files on the device (ls, push, pull, rm, mkdir) |
  194. | `metavr input` | Send input events to the device (keyevents, etc.) |
  195. | `metavr log` | View device logs (shortcut for adb logcat) |
  196. | `metavr mcp` | Start the MCP server for AI-agent integration |
  197. | `metavr perf` | Capture and analyze Perfetto performance traces |
  198. | `metavr update` | Update `metavr` to the latest version |
  199. | `metavr shell` | Run shell commands on the device |
  200. | `metavr skills` | Install and update the Meta Agent Skills bundle |
  201. | `metavr ssim` | Manage the SpatialSim emulator (download, start, status) |
  202. | `metavr tapedeck` | Record and replay OpenXR sessions via the Tapedeck API layer |
  203. | `metavr telemetry` | Manage telemetry consent settings (opt-in, opt-out, status) |
  204. | `metavr tools` | Manage developer tools (install, update, list, etc.) |
  205. | `metavr ui` | UI automation commands (dump hierarchy, tap elements, etc.) |
  206. | `metavr unity` | Unity Hub editor management (list installed editors, available releases) |
  207. | `metavr window` | Multi-window management (list windows, show focus) |
  208. | `metavr xroperator` | Manage the Meta XR Operator MCP proxy (readme, status, enable, disable) |
  209. | `metavr vrc-local` | VRC-local perf toolset (store-listing-check, perf-check, perf-agent, renderdoc-agent, perfetto-agent) |
  210. | `metavr xrsim` | Control the Meta XR Simulator frontend and connected OpenXR runtime |
  211. Run `metavr --help` or `metavr <group> --help` for full usage details.
  212. ## Repository structure
  213. ```
  214. .
  215. ├── .claude-plugin/ # Claude Code plugin configuration
  216. │ ├── plugin.json # Plugin metadata (name, version, keywords)
  217. │ └── marketplace.json # Marketplace listing
  218. ├── .cursor-plugin/ # Cursor plugin configuration
  219. │ ├── plugin.json # Plugin manifest with skills paths
  220. │ └── marketplace.json # Marketplace listing
  221. ├── .github/plugin/ # GitHub Copilot CLI plugin configuration
  222. │ ├── plugin.json # Plugin metadata with skills paths
  223. │ └── marketplace.json # Marketplace listing
  224. ├── .mcp.json # Shared MCP server config used by supported clients
  225. ├── docs/
  226. │ └── metavr-cli.md # Full metavr CLI reference
  227. ├── gemini-extension.json # Gemini-compatible MCP configuration
  228. ├── skills/ # One directory per skill
  229. │ └── ...
  230. ├── LICENSE # Apache 2.0
  231. ├── AGENTS.md # Agent navigation guide
  232. ├── CLAUDE.md # Symlink → AGENTS.md
  233. ├── CODE_OF_CONDUCT.md
  234. ├── CONTRIBUTING.md
  235. ├── SECURITY.md
  236. └── README.md
  237. ```
  238. Each skill directory contains a `SKILL.md` file. Supporting directories such as `references/`, `scripts/`, `assets/`, `examples/`, and `agents/` are optional and will be used only when they materially help the skill.
  239. ## Documentation map
  240. - [CONTRIBUTING.md](CONTRIBUTING.md) covers the general pull request flow for this repository.
  241. - [AGENTS.md](AGENTS.md) explains the current repo structure and the live skill inventory for coding agents.
  242. - [docs/metavr-cli.md](docs/metavr-cli.md) is the generated metavr CLI reference.
  243. ## Contributing
  244. We welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project.
  245. Note: PRs are not merged directly into this repo. Instead, they are pulled into a private fork, integrated there, and then mirrored back. Public PRs will typically be closed rather than merged directly.
  246. ## Code of Conduct
  247. This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to opensource-conduct@meta.com.
  248. ## License
  249. Apache 2.0 — see [LICENSE](LICENSE) for details.
  250. Copyright (c) 2026 Meta Platforms, Inc.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.