hz-vr-debug

Debug Meta Quest VR applications under Horizon OS using metavr commands.

176|17|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/meta-quest/agentic-tools --skill hz-vr-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hz-vr-debug
Source: https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-vr-debug
Command: npx skills add https://github.com/meta-quest/agentic-tools --skill hz-vr-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The hz-vr-debug Skill simplifies the process of troubleshooting VR/MR applications on Meta Quest devices by providing tools to view logs, capture screenshots, and diagnose issues efficiently.

Core Features & Use Cases

  • Log Viewing: Access live or historical logs for applications running on connected devices.
  • Screenshot Capture: Take screenshots of the current VR/MR view to document problems visually.
  • Issue Diagnostics: Use a suite of diagnostic commands to troubleshoot crashes, performance issues, and common problems like tracking loss and audio issues.
  • Use Case: As a developer, if your application crashes during use, the Skill allows you to view crash logs and screenshots, capture diagnostic data, and use predefined debugging workflows to identify the cause.

Quick Start

Start by listing all connected Quest devices and identifying the target app's package name. Run: metavr device list && metavr app list

Frequently Asked Questions about hz-vr-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I view crash logs for a Meta Quest VR application?

You can view Meta Quest VR application crash logs by using command-line tooling to access live or historical logs and capture crash reports on connected Horizon OS devices.

How do I capture screenshots from a Meta Quest headset for issue diagnostics?

Capture screenshots of the current VR or MR view on a Meta Quest headset by running diagnostic shell commands to visually document problems during application use.

Can I diagnose performance issues and tracking loss on Horizon OS devices?

Yes, diagnose performance issues, tracking loss, and audio problems on Horizon OS devices by utilizing a suite of diagnostic command-line commands and predefined debugging workflows.

What is the best way to start debugging an app on a connected Meta Quest device?

Start debugging by listing all connected Quest devices and identifying the target app's package name using the metavr device list and metavr app list shell commands.

Does VR debugging on Meta Quest require specific device-side file access?

VR debugging on Meta Quest requires device-side file access to handle errors, examine performance logs, and capture crash reports effectively through shell commands.

Why use command-line tooling instead of standard methods for Horizon OS log analysis?

Command-line tooling streamlines Horizon OS log analysis by providing predefined workflows to efficiently troubleshoot crashes, manage devices, and handle errors via direct device-side file access.