convez.ai
MCP ServerDesenvolvimento WebAvançado
meta-quest

Meta Quest Agentic Tools

meta-quest/agentic-tools

Skills agentic e MCP server para desenvolvimento VR em Meta Quest

Ver no GitHub
BomPluginScore · de 0 a 100

Conjunto de skills e ferramentas agentic para desenvolvimento em Meta Quest e Horizon OS, incluindo um servidor MCP com 40+ tools para gerenciamento de dispositivos, controle de apps e performance. Integra-se com Claude, Cursor, GitHub Copilot e Gemini para assistência de IA em desenvolvimento VR.

Instalação

$npx convez-ai meta-quest/agentic-tools

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
252
Forks
25
Acompanhando
6
Saúde
75%
Último commit
há 1 mês
Versão
v1.8.0
Issues abertas
9
Contribuidores
1

Casos de uso

  • Integrar assistentes de IA com dispositivos Meta Quest para desenvolvimento VR
  • Automatizar gerenciamento de devices e deploy de apps via MCP
  • Portar e desenvolver aplicações Android/2D para Meta Quest

Veredito

Ferramenta especializada e madura para integração de assistentes de IA com ecossistema Meta Quest/Horizon OS. Excelente para times de VR que querem automação via MCP servers em múltiplas IDEs e CLIs, mas requer conhecimento técnico de desenvolvimento VR e dispositivos Meta Quest.

README

A tradução para o português deste README ainda está na fila.

Meta Quest Agentic Tools

License: Apache 2.0 Meta Quest

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):
    npx -y metavr --version
    
  • Meta Quest device with Developer Mode 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 with:

/add-plugin meta-quest-agentic-tools

Or install online at: https://cursor.com/marketplace/meta-reality-labs

Gemini

gemini extensions install https://github.com/meta-quest/agentic-tools

MCP Server

metavr includes a built-in Model Context Protocol (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

# 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:

npx -y metavr mcp server

Bun users: substitute bunx metavr for npx -y metavr (no -y needed).

Skills

SkillDescription
metavr-cliProvides 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-portingGuides Android 2D app porting to Meta Quest and Horizon OS panels, including input adaptation, Gradle setup, compatibility, and panel layout.
hz-api-upgradeGuides Meta Quest and Horizon OS SDK/API upgrades, deprecated API replacements, migration planning, and changelog review.
hz-immersive-designerReviews Meta Quest and Horizon OS VR/MR experiences for comfort, accessibility, spatial layout, and interaction quality.
hz-iwsdk-webxrBuilds WebXR experiences for Meta Quest and Horizon OS using the Immersive Web SDK, Three.js, ECS patterns, and spatial UI.
hz-new-project-creationScaffolds new Meta Quest and Horizon OS projects across Unity, Unreal, Android/Spatial SDK, and WebXR.
hz-perfetto-debugAnalyzes Meta Quest and Horizon OS performance with Perfetto traces, including frame timing, CPU/GPU bottlenecks, and thermal issues.
hz-platform-sdkGuides Horizon Platform SDK API usage for Meta Quest and Horizon OS Android/Kotlin apps across the public platform packages.
hz-psdk-integrationGuides interactive Horizon Platform SDK integration for Meta Quest and Horizon OS Android/Kotlin projects, from codebase analysis through on-device validation.
hz-quest-verify-firstForces docs-first verification against current Meta Quest and Horizon OS documentation and metavr capabilities before answering or editing Quest-specific code.
hz-simpleperf-debugProfiles Meta Quest and Horizon OS CPU performance with simpleperf, including workload classification, hotspot recording, and kernel overhead analysis.
hz-spatial-sdkBuilds spatial Android apps for Meta Quest and Horizon OS with Meta Spatial SDK, including ECS architecture, panels, 3D objects, and hybrid experiences.
hz-store-submitGuides 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-reviewReviews Unity code targeting Meta Quest and Horizon OS for rendering, performance, input handling, allocations, and common VR pitfalls.
hz-unity-fbx-importEnsures 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-sdkGuides 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-uiConfigures Unity UI for Meta Quest and Horizon OS VR development, including world-space canvases, TextMesh Pro, sizing, and interaction readiness.
hz-unity-placementEnsures accurate object placement in Unity projects targeting Meta Quest and Horizon OS using Renderer and Collider bounds.
hz-unity-platform-sdkGuides 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-analyzerAnalyzes and maintains .agent-docs/ project knowledge bases for Unity projects targeting Meta Quest and Horizon OS.
hz-unity-tmp-resourcesImports and verifies TextMesh Pro Essential Resources for Unity projects targeting Meta Quest and Horizon OS.
hz-vr-debugDebugs Meta Quest and Horizon OS VR/MR apps with metavr logs, screenshots, app inspection, and common issue diagnosis.
hz-xr-simulator-setupSets up Meta XR Simulator workflows for testing Meta Quest and Horizon OS Unity or Unreal apps without a physical device.
portalBuilds 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 groupPurpose
metavr deviceList, connect, reboot, and query connected Quest devices
metavr appInstall, launch, stop, and inspect apps on a device
metavr captureCapture screenshots
metavr filesManage files on the device (ls, push, pull, rm)
metavr perfCapture and analyze Perfetto performance traces
metavr docsSearch Meta Quest developer documentation
metavr assetSearch Meta's 3D asset library
metavr configManage CLI configuration settings
metavr logView device logs (shortcut for adb logcat)
metavr shellRun shell commands on the device
metavr adbDirect ADB passthrough commands
metavr mcpStart 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 covers the general pull request flow for this repository.
  • AGENTS.md explains the current repo structure and the live skill inventory for coding agents.
  • docs/hzdb.md is the generated Meta VR CLI reference.

Contributing

We welcome contributions! Please read our Contributing Guide 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. By participating, you are expected to uphold this code. Please report unacceptable behavior to opensource-conduct@meta.com.

License

Apache 2.0 — see LICENSE for details.

Copyright (c) 2026 Meta Platforms, Inc.

Ver o original no GitHub

Bom para

Relacionados