meta-vr

Meta Quest Agentic Tools

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

  npx -y metavr --version
  

  Using Bun? 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 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

Codex

codex plugin marketplace add meta-quest/agentic-tools
codex plugin install meta-vr

GitHub Copilot CLI

copilot plugin marketplace add meta-quest/agentic-tools
copilot plugin install meta-vr@meta-quest

Gemini

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 releases and installable with the built-in gh skill command. Requires a recent GitHub CLI (gh) — gh skill is a preview feature.

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

# Add every skill from this repo
npx skills add meta-quest/agentic-tools

Browse the catalog at skills.sh/meta-quest/agentic-tools.

Context7 (npx ctx7)

# 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 (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).

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