{
  "markdown": "# Meta Quest Agentic Tools\n\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n[![Meta Quest](https://img.shields.io/badge/Meta_Quest-Developer-1877F2)](https://developers.meta.com/horizon/)\n\nAgentic skills and tools for Meta Quest and Horizon OS development.\n\n## What is this?\n\nThis 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.\n\nThe 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.\n\nSkills 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.\n\n## Prerequisites\n\n- **Node.js** 18 or later\n- **metavr CLI** — invoke via `npx` (no install required):\n  ```bash\n  npx -y metavr --version\n  ```\n  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`).\n- **Meta Quest device** with [Developer Mode](https://developers.meta.com/horizon/documentation/native/android/mobile-device-setup/) enabled (for on-device skills)\n\n## Installation\n\n### Claude Code\n\nAdd Meta Quest Agentic Tools marketplace and install the agentic tools plugin\n\nWithin claude run:\n\n```\n/plugin marketplace add meta-quest/agentic-tools\n/plugin install meta-vr@meta-quest\n```\n\n### Cursor\n\nInstall from the [Cursor marketplace](https://cursor.com/marketplace/meta-reality-labs) with:\n\n```\n/add-plugin meta-quest-agentic-tools\n```\n\nOr install online at: https://cursor.com/marketplace/meta-reality-labs\n\n### Codex\n\n```bash\ncodex plugin marketplace add meta-quest/agentic-tools\ncodex plugin install meta-vr\n```\n\n### GitHub Copilot CLI\n\n```bash\ncopilot plugin marketplace add meta-quest/agentic-tools\ncopilot plugin install meta-vr@meta-quest\n```\n\n### Gemini\n\n```bash\ngemini extensions install https://github.com/meta-quest/agentic-tools\n```\n\n## Install with a skills CLI\n\nPrefer 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.\n\n### Agent Skills CLI (`gh skill`)\n\nPublished 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.\n\n```bash\n# Install all skills from this repo\ngh skill install meta-quest/agentic-tools\n\n# Install a single skill\ngh skill install meta-quest/agentic-tools hz-spatial-sdk\n\n# Target a specific agent, or install for all projects\ngh skill install meta-quest/agentic-tools --agent claude-code --scope user\n```\n\n### skills.sh (`npx skills`)\n\n```bash\n# Add every skill from this repo\nnpx skills add meta-quest/agentic-tools\n```\n\nBrowse the catalog at [skills.sh/meta-quest/agentic-tools](https://skills.sh/meta-quest/agentic-tools).\n\n### Context7 (`npx ctx7`)\n\n```bash\n# Interactive — pick from a list\nnpx ctx7@latest skills install /meta-quest/agentic-tools\n\n# Install a specific skill, or everything\nnpx ctx7@latest skills install /meta-quest/agentic-tools hz-spatial-sdk\nnpx ctx7@latest skills install /meta-quest/agentic-tools --all\n\n# Target a specific IDE: --claude, --cursor, --universal (.agents/skills/), or --global\nnpx ctx7@latest skills install /meta-quest/agentic-tools --all --claude\n```\n\n\n## MCP Server\n\nmetavr 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.\n\n### Install the MCP server into your AI tool\n\n> **Bun users:** replace `npx -y metavr` with `bunx metavr` in any command below (no `-y` needed).\n\n```bash\n# Claude Code\nnpx -y metavr mcp install claude-code\n\n# Claude Desktop\nnpx -y metavr mcp install claude-desktop\n\n# Cursor\nnpx -y metavr mcp install cursor\n\n# VS Code / VS Code Insiders\nnpx -y metavr mcp install vscode\nnpx -y metavr mcp install vscode-insiders\n\n# Windsurf\nnpx -y metavr mcp install windsurf\n\n# Zed\nnpx -y metavr mcp install zed\n\n# Android Studio (Gemini)\nnpx -y metavr mcp install android-studio\n\n# Gemini CLI\nnpx -y metavr mcp install gemini-cli\n\n# OpenAI Codex CLI\nnpx -y metavr mcp install codex\n\n# LM Studio\nnpx -y metavr mcp install lm-studio\n\n# OpenCode\nnpx -y metavr mcp install open-code\n\n# Google Antigravity (Gemini)\nnpx -y metavr mcp install antigravity\n\n# Generic project-local config\nnpx -y metavr mcp install project\n```\n\nOr start the MCP server directly:\n\n```bash\nnpx -y metavr mcp server\n```\n\n## Skills\n\n<!-- BEGIN GENERATED: skills-table (managed by tools/export_skills.py) -->\n| Skill | Description |\n|-------|-------------|\n| `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. |\n| `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. |\n| `hz-api-upgrade` | Guides Meta Quest and Horizon OS SDK/API upgrades, deprecated API replacements, migration planning, and changelog review. |\n| `hz-immersive-designer` | Reviews Meta Quest and Horizon OS VR/MR experiences for comfort, accessibility, spatial layout, and interaction quality. |\n| `hz-iwsdk-webxr` | Builds WebXR experiences for Meta Quest and Horizon OS using the Immersive Web SDK, Three.js, ECS patterns, and spatial UI. |\n| `hz-new-project-creation` | Scaffolds new Meta Quest and Horizon OS projects across Unity, Unreal, Android/Spatial SDK, and WebXR. |\n| `hz-perfetto-debug` | Analyzes Meta Quest and Horizon OS performance with Perfetto traces, including frame timing, CPU/GPU bottlenecks, and thermal issues. |\n| `hz-platform-sdk` | Guides Horizon Platform SDK API usage for Meta Quest and Horizon OS Android/Kotlin apps across the public platform packages. |\n| `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. |\n| `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. |\n| `hz-simpleperf-debug` | Profiles Meta Quest and Horizon OS CPU performance with simpleperf, including workload classification, hotspot recording, and kernel overhead analysis. |\n| `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. |\n| `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. |\n| `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. |\n| `hz-unity-code-review` | Reviews Unity code targeting Meta Quest and Horizon OS for rendering, performance, input handling, allocations, and common VR pitfalls. |\n| `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. |\n| `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. |\n| `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. |\n| `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. |\n| `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). |\n| `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. |\n| `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. |\n| `hz-unity-placement` | Ensures accurate object placement in Unity projects targeting Meta Quest and Horizon OS using Renderer and Collider bounds. |\n| `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. |\n| `hz-unity-project-analyzer` | Analyzes and maintains `.agent-docs/` project knowledge bases for Unity projects targeting Meta Quest and Horizon OS. |\n| `hz-unity-tmp-resources` | Imports and verifies TextMesh Pro Essential Resources for Unity projects targeting Meta Quest and Horizon OS. |\n| `hz-vr-debug` | Debugs Meta Quest and Horizon OS VR/MR apps with metavr logs, screenshots, app inspection, and common issue diagnosis. |\n| `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. |\n| `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. |\n<!-- END GENERATED: skills-table -->\n\n## metavr CLI quick reference\n\nmetavr organizes commands into groups:\n\n| Command group | Purpose |\n|---------------|---------|\n| `metavr device` | List, connect, reboot, and query connected Quest devices |\n| `metavr app` | Install, launch, stop, and inspect apps on a device |\n| `metavr capture` | Capture screenshots |\n| `metavr files` | Manage files on the device (ls, push, pull, rm) |\n| `metavr perf` | Capture and analyze Perfetto performance traces |\n| `metavr docs` | Search Meta Quest developer documentation |\n| `metavr asset` | Search Meta's 3D asset library |\n| `metavr config` | Manage CLI configuration settings |\n| `metavr log` | View device logs (shortcut for adb logcat) |\n| `metavr shell` | Run shell commands on the device |\n| `metavr adb` | Direct ADB passthrough commands |\n| `metavr mcp` | Start the MCP server for AI-agent integration |\n\nRun `npx -y metavr --help` or `npx -y metavr <group> --help` for full usage details.\n\n## Repository structure\n\n```\n.\n├── .claude-plugin/          # Claude Code plugin configuration\n│   ├── plugin.json          # Plugin metadata (name, version, keywords)\n│   └── marketplace.json     # Marketplace listing\n├── .cursor-plugin/          # Cursor plugin configuration\n│   ├── plugin.json          # Plugin manifest with skills paths\n│   └── marketplace.json     # Marketplace listing\n├── .github/plugin/          # GitHub Copilot CLI plugin configuration\n│   ├── plugin.json          # Plugin metadata with skills paths\n│   └── marketplace.json     # Marketplace listing\n├── .mcp.json                # Shared MCP server config used by supported clients\n├── docs/\n│   └── hzdb.md              # Full metavr CLI reference\n├── gemini-extension.json    # Gemini-compatible MCP configuration\n├── skills/                  # One directory per skill\n│   └── ...\n├── LICENSE                  # Apache 2.0\n├── AGENTS.md                # Agent navigation guide\n├── CLAUDE.md                # Symlink → AGENTS.md\n├── CODE_OF_CONDUCT.md\n├── CONTRIBUTING.md\n├── SECURITY.md\n└── README.md\n```\n\nEach 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.\n\n## Documentation map\n\n- [CONTRIBUTING.md](CONTRIBUTING.md) covers the general pull request flow for this repository.\n- [AGENTS.md](AGENTS.md) explains the current repo structure and the live skill inventory for coding agents.\n- [docs/hzdb.md](docs/hzdb.md) is the generated metavr CLI reference.\n\n## Contributing\n\nWe welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project.\n\nNote: 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.\n\n## Code of Conduct\n\nThis 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.\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE) for details.\n\nCopyright (c) 2026 Meta Platforms, Inc.\n",
  "bytes": 14443,
  "sha": "f8a4bce6705850c0aeb78438f2df378cc263e8cd7e37808afbb5f53e72ffc619",
  "repo_slug": "meta-quest/agentic-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_meta_quest_agentic_tools_9805065a/readme"
}