Content
# 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 Meta VR CLI (`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, GitHub Copilot CLI, and Gemini-compatible environments.
Skills are powered by the **Meta VR CLI** (`metavr`), 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
- **Meta VR CLI** (`metavr`) — invoke via `npx` (no install required):
```bash
npx -y 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
### Gemini
```bash
gemini extensions install https://github.com/meta-quest/agentic-tools
```
### Agent Skills CLI (`gh skill`)
These skills are published as [Agent Skills](https://agentskills.io) releases and can be installed with the built-in `gh skill` command, independent of any specific editor or plugin marketplace. 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
# Pin to a specific release tag
gh skill install meta-quest/agentic-tools hz-spatial-sdk --pin v1.2.1
```
By default skills install at project scope for GitHub Copilot. Use `--agent` (e.g. `claude-code`, `cursor`, `codex`, `gemini-cli`) and `--scope user` to target a specific agent or make skills available everywhere:
```bash
gh skill install meta-quest/agentic-tools --agent claude-code --scope user
```
## 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
```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
```
> Bun users: substitute `bunx metavr` for `npx -y metavr` (no `-y` needed).
## Skills
| 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-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-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-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-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. |
## Meta VR 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 Meta VR 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 Meta VR 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.
Connection Info
You Might Also Like
everything-claude-code
Complete Claude Code configuration collection - agents, skills, hooks,...
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
cc-switch
All-in-One Assistant for Claude Code, Codex & Gemini CLI across platforms.
servers
Model Context Protocol Servers
servers
Model Context Protocol Servers
Time
A Model Context Protocol server for time and timezone conversions.