Meta Quest Agentic Tools

The metavr CLI provides commands to search and retrieve Meta Quest developer documentation directly from the terminal. This allows for quick lookups of APIs, guides, and best practices without leaving your development environment.

Command Summary

The Achievements API is part of the Horizon Platform SDK (Kotlin package: horizon.platform.achievements). It allows developers to award trophies, badges, and awards. The API supports three achievement types:

• Simple: All-or-nothing; unlocked by a single event.
• Count: Unlocked when a counter reaches a defined target.
• Bitfield: Unlocked when a target number of bits in a bitfield are set.

Technical Details:

• Maven Artifact: horizon-platform-sdk-achievements-kotlin
• Minimum OS: HzOS v85 (public), HzOS v83 (partner)
• Error Handling: All methods throw AchievementsException (which extends HzPlatformSdkException). Always wrap calls in try/catch blocks.

The Achievements API (part of the com.meta.xr.sdk.platform Unity package) allows developers to manage player achievements within the Meta Quest ecosystem. It supports three primary achievement types:

1. Simple: One-shot events (e.g., "Completed tutorial").
2. Count: Cumulative progress (e.g., "Defeat 100 enemies").
3. Bitfield: Collect-them-all sets (e.g., "Find all 7 hidden gems").

Achievements automatically integrate with Meta Quest Home. The server is the source of truth; developers should fetch progress from the API rather than relying on local state.

The Asset File API is part of the Horizon Platform SDK Unity package (com.meta.xr.sdk.platform). It allows Meta Quest Unity applications to manage downloadable content (DLC), expansion packs, and optional assets.

Key capabilities include:

• Listing all configured assets.
• Checking the installation status of specific assets by name or ID.
• Downloading single assets or performing atomic batch downloads.
• Cancelling active downloads and deleting installed assets.
• Retrieving local file paths for loading assets (e.g., AssetBundles) at runtime.

The Users API for the Meta Quest Horizon Platform SDK allows Android applications to access user information and perform identity verification.

Key Capabilities:

• Retrieve user profiles by app-scoped ID.
• Access the currently signed-in user (available offline).
• Retrieve the logged-in user's bidirectional followers (friends).
• Obtain access tokens for REST API calls to graph.oculus.com.
• Perform server-side identity verification using a single-use nonce (getUserProof).
• Retrieve organization-scoped IDs for cross-app identification within a developer organization.

Technical Details:

• Kotlin Package: horizon.platform.users
• Maven Artifact: horizon-platform-sdk-users-kotlin
• Minimum OS: HzOS v78

Note: For setup, initialization, and client instantiation, refer to common-setup.md.

Meta Quest Agentic Tools provides a curated set of agentic skills and tools designed for Meta Quest and Horizon OS development. These tools are built around the metavr (Meta VR CLI), which enables device management, app management, performance tooling, and documentation search.

Key components include:

• Agentic Skills: Follow the open Agent Skills model, where each skill contains a SKILL.md and optional supporting files loaded on demand.
• metavr CLI: The core engine providing direct commands and an MCP (Model Context Protocol) server for AI interaction.
• Packaging: Support for major AI environments including Claude Code, Cursor, Codex, GitHub Copilot CLI, and Gemini.

The hz-api-upgrade skill is designed to assist in upgrading Meta Quest applications to newer Horizon OS SDK versions. It provides guidance on migration paths, deprecated API replacements, and changelog analysis.

Use this skill when:

• Upgrading an existing Quest application to a newer Horizon OS SDK version.
• Fixing deprecated API warnings or compilation errors after an SDK update.
• Migrating between major API versions (e.g., VrApi to OpenXR).
• Understanding changes between SDK releases.
• Planning an upgrade path for projects that have fallen behind on SDK versions.

Use the hz-unity-platform-sdk skill to integrate Horizon Platform SDK features into Unity Meta Quest applications. This skill covers setup, initialization, and API usage for all 18 public platform SDK packages, including achievements, IAP, users, leaderboards, and more.

Note: If you are developing for Android/Kotlin apps, use the hz-platform-sdk skill instead.

The Rich Presence API allows Meta Quest Android applications to manage user presence information (what they are doing and where they are).

Note: This API is deprecated. New integrations should use the Group Presence API instead.

Integration Details

• Kotlin Package: horizon.platform.richpresence
• Minimum OS: HzOS v85
• Maven Artifact: horizon-platform-sdk-rich-presence-kotlin

For setup, initialization, and client instantiation, refer to common-setup.md.

The hz-unity-project-analyzer is an agentic skill designed to analyze, document, and maintain a living knowledge base for Unity projects targeting Meta Quest and Horizon OS. It creates a .agent-docs/ directory containing source-control-friendly markdown files optimized for AI agent comprehension.

Use this skill when you need to:

• Scan a project's structure.
• Explain how a specific Unity system works.
• Update project documentation after structural changes (new scenes, scripts, prefabs, etc.).

The hz-immersive-designer skill is a knowledge base for designing comfortable, intuitive, and accessible VR and MR experiences on Meta Quest and Horizon OS.

Use this skill when:

• Designing new VR/MR experiences.
• Reviewing existing Quest application UX.
• Evaluating spatial interface comfort and usability.
• Planning interaction models or accessibility compliance.
• Troubleshooting motion sickness or eye strain issues.