meta-quest

meta-quest/agentic-tools

Agent skills for Meta Quest and Horizon OS development.

MCP Server

hzdb 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 @meta-quest/hzdb mcp install claude-code

# Claude Desktop
npx -y @meta-quest/hzdb mcp install claude-desktop

# Cursor
npx -y @meta-quest/hzdb mcp install cursor

# VS Code / VS Code Insiders
npx -y @meta-quest/hzdb mcp install vscode
npx -y @meta-quest/hzdb mcp install vscode-insiders

# Windsurf
npx -y @meta-quest/hzdb mcp install windsurf

# Zed
npx -y @meta-quest/hzdb mcp install zed

# Android Studio (Gemini)
npx -y @meta-quest/hzdb mcp install android-studio

# Gemini CLI
npx -y @meta-quest/hzdb mcp install gemini-cli

# OpenAI Codex CLI
npx -y @meta-quest/hzdb mcp install codex

# LM Studio
npx -y @meta-quest/hzdb mcp install lm-studio

# OpenCode
npx -y @meta-quest/hzdb mcp install open-code

# Google Antigravity (Gemini)
npx -y @meta-quest/hzdb mcp install antigravity

# Generic project-local config
npx -y @meta-quest/hzdb mcp install project

Or start the MCP server directly:

npx -y @meta-quest/hzdb mcp server

What is this?

meta-quest/agentic-tools is an agent skills plugin for Claude Code, GitHub Copilot CLI, and Cursor that provides 13 agent skills for Meta Quest development. The skills cover the full development lifecycle — from project scaffolding and code review to performance profiling and device debugging.

Skills are powered by the hzdb (Horizon Debug Bridge) 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
• hzdb CLI — install globally or use via npx:

  npm install -g @meta-quest/hzdb
  

• Meta Quest device with Developer Mode enabled (for on-device skills)

Installation

Claude Code

From the Claude Code marketplace:

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

Or clone and add locally:

git clone https://github.com/meta-quest/agentic-tools.git
claude plugin add ./agentic-tools

GitHub Copilot CLI

copilot plugin install meta-quest/agentic-tools

Cursor

Install from the Cursor marketplace, or clone and add locally:

git clone https://github.com/meta-quest/agentic-tools.git

Then open Cursor Settings > Plugins and add the cloned directory as a local plugin.

Skills

Skill	Description
hzdb-cli	Complete hzdb CLI reference — installation, all commands, MCP server, deep-dive docs
hz-perfetto-debug	VR performance analysis with Perfetto traces
hz-new-project-creation	Scaffold new Quest projects (Unity, Unreal, Spatial SDK, WebXR)
hz-xr-simulator-setup	Set up Meta XR Simulator for device-free testing
hz-unity-code-review	Review Unity code for Quest performance best practices
hz-android-2d-porting	Port Android 2D apps to Quest / Horizon OS
hz-iwsdk-webxr	Build WebXR experiences with the Immersive Web SDK
hz-api-upgrade	Migrate apps to newer Horizon OS SDK versions
hz-immersive-designer	UX design principles for VR/MR
hz-spatial-sdk	Build native spatial apps with Meta Spatial SDK
hz-vr-debug	Debug Quest apps using the hzdb CLI
hz-vrc-check	Validate apps against VRC store publishing requirements
hz-platform-sdk	Horizon Platform SDK Android/Kotlin integration (17 API packages)

hzdb CLI quick reference

hzdb organizes commands into groups: