meta-vr
Agent skills for Meta Quest and Horizon OS development. Helps Claude assist with Quest app debugging, performance analysis, project setup, U
Open source Open in the app JSON README (API)
About
Agent skills for Meta Quest and Horizon OS development. Helps Claude assist with Quest app debugging, performance analysis, project setup, Unity and WebXR workflows, Spatial SDK and Platform SDK integration, store submission checks, and metavr device workflows.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- meta-quest
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.2.3
- Stars
- 189
- Forks
- 17
- Open pull requests
- 1
- Last push
- 2026-08-21T22:46:20Z
- Repository state
- ativo
- Language
- C#
- License
- Apache-2.0
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
meta-quest/agentic-tools
README
# Meta Quest Agentic Tools [](LICENSE) [](https://developers.meta.com/horizon/) Agentic skills and tools for Meta Quest and Horizon OS development. ## What is this? This repository packages a curated set of agentic tools and skills for Meta Quest and Horizon OS development, along with shared `metavr` references and contribution/process documentation for maintaining the skill ecosystem. 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. 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. ## Prerequisites - **Node.js** 18 or later - **metavr CLI** — invoke via `npx` (no install required): ```bash npx -y metavr --version ``` Using [Bun](https://bun.sh)? Substitute `bunx metavr` for `npx -y metavr` in any command in this README — no `-y` is needed (e.g. `bunx metavr --version`). - **Meta Quest device** with [Developer Mode](https://developers.meta.com/horizon/documentation/native/android/mobile-device-setup/) enabled (for on-device skills) ## Installation ### Claude Code Add Meta Quest Agentic Tools marketplace and install the agentic tools plugin Within claude run: ``` /plugin marketplace add meta-quest/agentic-tools /plugin install meta-vr@meta-quest ``` ### Cursor Install from the [Cursor marketplace](https://cursor.com/marketplace/meta-reality-labs) with: ``` /add-plugin meta-quest-agentic-tools ``` Or install online at: https://cursor.com/marketplace/meta-reality-labs ### Codex ```bash codex plugin marketplace add meta-quest/agentic-tools codex plugin install meta-vr ``` ### GitHub Copilot CLI ```bash copilot plugin marketplace add meta-quest/agentic-tools copilot plugin install meta-vr@meta-quest ``` ### Gemini ```bash gemini extensions install https://github.com/meta-quest/agentic-tools ``` ## Install with a skills CLI Prefer to install the skills directly — independent of any specific editor or plugin marketplace? These editor-agnostic CLIs install the skills from this repo into whichever agent you choose. ### Agent Skills CLI (`gh skill`) 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. ```bash # Install all skills from this repo gh skill install meta-quest/agentic-tools # Install a single skill gh skill install meta-quest/agentic-tools hz-spatial-sdk # Target a specific agent, or install for all projects gh skill install meta-quest/agentic-tools --agent claude-code --scope user ``` ### skills.sh (`npx skills`) ```bash # Add every skill from this repo npx skills add meta-quest/agentic-tools ``` Browse the catalog at [skills.sh/meta-quest/agentic-tools](https://skills.sh/meta-quest/agentic-tools). ### Context7 (`npx ctx7`) ```bash # Interactive — pick from a list npx ctx7@latest skills install /meta-quest/agentic-tools # Install a specific skill, or everything npx ctx7@latest skills install /meta-quest/agentic-tools hz-spatial-sdk npx ctx7@latest skills install /meta-quest/agentic-tools --all # Target a specific IDE: --claude, --cursor, --universal (.agents/skills/), or --global npx ctx7@latest skills install /meta-quest/agentic-tools --all --claude ``` ## MCP Server 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 Quest device. ### Install the MCP server into your AI tool > **Bun users:** replace `npx -y metavr` with `bunx metavr` in any command below (no `-y` needed). ```bash # Claude Code npx -y metavr mcp install claude-code # Claude Desktop npx -y metavr mcp install claude-desktop # Cursor npx -y metavr mcp install cursor # VS Code / VS Code Insiders npx -y metavr mcp install vscode npx -y metavr mcp install vscode-insiders # Windsurf npx -y metavr mcp install windsurf # Zed npx -y metavr mcp install zed # Android Studio (Gemini) npx -y metavr mcp install android-studio # Gemini CLI npx -y metavr mcp install gemini-cli # OpenAI Codex CLI npx -y metavr mcp install codex # LM Studio npx -y metavr mcp install lm-studio # OpenCode npx -y metavr mcp install open-code # Google Antigravity (Gemini) npx -y metavr mcp install antigravity # Generic project-local config npx -y metavr mcp install project ``` Or start the MCP server directly: ```bash npx -y metavr mcp server ``` ## Skills <!-- BEGIN GENERATED: skills-table (managed by tools/export_skills.py) --> | Skill | Description | |-------|-------------| | `metavr-cli` | Provides the Meta VR CLI (`metavr` command) reference for Meta Quest and Horizon OS device management, app management, docs search, audio control, test setup, performance tooling, and MCP usage. | | `hz-android-2d-porting` | Guides Android 2D app porting to Meta Quest and Horizon OS panels, including input adaptation, Gradle setup, compatibility, and panel layout. | | `hz-api-upgrade` | Guides Meta Quest and Horizon OS SDK/API upgrades, deprecated API replacements, migration planning, and changelog review. | | `hz-immersive-designer` | Reviews Meta Quest and Horizon OS VR/MR experiences for comfort, accessibility, spatial layout, and interaction quality. | | `hz-iwsdk-webxr` | Builds WebXR experiences for Meta Quest and Horizon OS using the Immersive Web SDK, Three.js, ECS patterns, and spatial UI. | | `hz-new-project-creation` | Scaffolds new Meta Quest and Horizon OS projects across Unity, Unreal, Android/Spatial SDK, and WebXR. | | `hz-perfetto-debug` | Analyzes Meta Quest and Horizon OS performance with Perfetto traces, including frame timing, CPU/GPU bottlenecks, and thermal issues. | | `hz-platform-sdk` | Guides Horizon Platform SDK API usage for Meta Quest and Horizon OS Android/Kotlin apps across the public platform packages. | | `hz-psdk-integration` | Guides interactive Horizon Platform SDK integration for Meta Quest and Horizon OS Android/Kotlin projects, from codebase analysis through on-device validation. | | `hz-quest-verify-first` | Forces docs-first verification against current Meta Quest and Horizon OS documentation and metavr capabilities before answering or editing Quest-specific code. | | `hz-simpleperf-debug` | Profiles Meta Quest and Horizon OS CPU performance with simpleperf, including workload classification, hotspot recording, and kernel overhead analysis. | | `hz-spatial-sdk` | Builds spatial Android apps for Meta Quest and Horizon OS with Meta Spatial SDK, including ECS architecture, panels, 3D objects, and hybrid experiences. | | `hz-store-pwa` | Guides shipping a web app to the Meta Quest and Horizon OS Store as a PWA/TWA, both 2D windowed panels and immersive WebXR, covering the IWSDK/web build, Vercel deploy, PWA manifest and icons, bubblewrap packaging with keystore and Digital Asset Links, and ovr-platform-util upload. | | `hz-store-submit` | Guides Meta Quest and Horizon OS app submission to the Meta Horizon Store, including build validation, VRC compliance, assets, upload, and review tracking. | | `hz-unity-code-review` | Reviews Unity code targeting Meta Quest and Horizon OS for rendering, performance, input handling, allocations, and common VR pitfalls. | | `hz-unity-face-tracking` | Drives ARKit-blendshape-rigged head/face models in Unity from the wearer's facial expressions on Meta Quest and Horizon OS via Meta Movement SDK (face tracking + Audio-to-Expression), for FBX models with the 52 ARKit blendshapes on Quest Pro / Quest 3 / Quest 3S. | | `hz-unity-fbx-import` | Ensures complete FBX URLs or absolute paths are used when importing external 3D models into Unity projects targeting Meta Quest and Horizon OS. | | `hz-unity-meta-core-sdk` | Guides Meta XR Core SDK (`com.meta.xr.sdk.core`) usage for Meta Quest and Horizon OS Unity XR development, including OVRManager, OVRCameraRig, passthrough, hand tracking, spatial anchors, boundaryless mode, controller input, Scene API, OVRProjectSetup, and AndroidManifest generation. | | `hz-unity-meta-mixed-reality-utility-kit` | Builds scene-aware mixed reality in Unity for Meta Quest and Horizon OS with the Meta XR Mixed Reality Utility Kit (MRUK / `com.meta.xr.mrutilitykit`), including Scene API data, anchor-based prefab spawning, world locking, room-geometry raycasting, NavMesh generation, passthrough camera access, trackable detection, and room sharing. | | `hz-unity-meta-movement-sdk-retargeting` | Sets up and tweaks Meta Movement SDK (MSDK) retargeting for humanoid character models on Meta Quest and Horizon OS, generating the retargeting config and hand-editing the resulting `<asset>.json` (joint mappings, mapping weights and behaviors, T-pose values). | | `hz-unity-meta-quest-ui` | Configures Unity UI for Meta Quest and Horizon OS VR development, including world-space canvases, TextMesh Pro, sizing, and interaction readiness. | | `hz-unity-passthrough-camera-access` | Accesses the forward-facing RGB cameras on Meta Quest and Horizon OS (Quest 3 / Quest 3S) via Passthrough Camera Access (PCA) in Unity to feed Computer Vision and ML pipelines, covering camera image/texture capture, pose and intrinsics, pixel-to-world projection, resolution, and permissions. | | `hz-unity-placement` | Ensures accurate object placement in Unity projects targeting Meta Quest and Horizon OS using Renderer and Collider bounds. | | `hz-unity-platform-sdk` | Guides Horizon Platform SDK integration for Meta Quest and Horizon OS Unity/C# apps across all 18 public platform packages, including achievements, IAP, users, leaderboards, challenges, presence, notifications, entitlements, setup, initialization, and error handling. | | `hz-unity-project-analyzer` | Analyzes and maintains `.agent-docs/` project knowledge bases for Unity projects targeting Meta Quest and Horizon OS. | | `hz-unity-tmp-resources` | Imports and verifies TextMesh Pro Essential Resources for Unity projects targeting Meta Quest and Horizon OS. | | `hz-vr-debug` | Debugs Meta Quest and Horizon OS VR/MR apps with metavr logs, screenshots, app inspection, and common issue diagnosis. | | `hz-xr-simulator-setup` | Sets up Meta XR Simulator workflows for testing Meta Quest and Horizon OS Unity or Unreal apps without a physical device. | | `portal` | Builds and sideloads Android apps for Meta Portal devices (Portal, Portal+, Portal Mini, Portal Go, Portal TV) with metavr, covering ADB enablement, the no-GMS constraint, launcher intent-filters, icon density quirks, the Smart Camera SDK, and the gradle build/deploy/debug loop. | <!-- END GENERATED: skills-table --> ## metavr CLI quick reference metavr organizes commands into groups: | Command group | Purpose | |---------------|---------| | `metavr device` | List, connect, reboot, and query connected Quest devices | | `metavr app` | Install, launch, stop, and inspect apps on a device | | `metavr capture` | Capture screenshots | | `metavr files` | Manage files on the device (ls, push, pull, rm) | | `metavr perf` | Capture and analyze Perfetto performance traces | | `metavr docs` | Search Meta Quest developer documentation | | `metavr asset` | Search Meta's 3D asset library | | `metavr config` | Manage CLI configuration settings | | `metavr log` | View device logs (shortcut for adb logcat) | | `metavr shell` | Run shell commands on the device | | `metavr adb` | Direct ADB passthrough commands | | `metavr mcp` | Start the MCP server for AI-agent integration | Run `npx -y metavr --help` or `npx -y metavr <group> --help` for full usage details. ## Repository structure ``` . ├── .claude-plugin/ # Claude Code plugin configuration │ ├── plugin.json # Plugin metadata (name, version, keywords) │ └── marketplace.json # Marketplace listing ├── .cursor-plugin/ # Cursor plugin configuration │ ├── plugin.json # Plugin manifest with skills paths │ └── marketplace.json # Marketplace listing ├── .github/plugin/ # GitHub Copilot CLI plugin configuration │ ├── plugin.json # Plugin metadata with skills paths │ └── marketplace.json # Marketplace listing ├── .mcp.json # Shared MCP server config used by supported clients ├── docs/ │ └── hzdb.md # Full metavr CLI reference ├── gemini-extension.json # Gemini-compatible MCP configuration ├── skills/ # One directory per skill │ └── ... ├── LICENSE # Apache 2.0 ├── AGENTS.md # Agent navigation guide ├── CLAUDE.md # Symlink → AGENTS.md ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── SECURITY.md └── README.md ``` 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. ## Documentation map - [CONTRIBUTING.md](CONTRIBUTING.md) covers the general pull request flow for this repository. - [AGENTS.md](AGENTS.md) explains the current repo structure and the live skill inventory for coding agents. - [docs/hzdb.md](docs/hzdb.md) is the generated metavr CLI reference. ## Contributing 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. 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. ## Code of Conduct 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. ## License Apache 2.0 — see [LICENSE](LICENSE) for details. Copyright (c) 2026 Meta Platforms, Inc.