# hz-xr-simulator-control

> Claude/Codex skill by [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars · Updated 2026-09-24

Routes Meta VR and Horizon OS simulator work to the right \`metavr\` command group, and drives a running Meta XR Simulator via \`metavr xrsim\` — runtime, device, input, compositor layers and MP4 recording. Use when a goal concerns a simulated headset rather than a physical one, when choosing between \`xrsim\`, \`ssim\`, \`capture\` and \`tapedeck\`, or when a \`metavr xrsim\` command returns a connection error. For installing the simulator or configuring it into a Unity, Unreal or native OpenXR project, use hz-xr-simulator-install-and-configure instead.

Tags: adb, agent-skills, cli, dev-tools, horizon-os, mcp, mcp-server, meta, meta-quest, mixed-reality, model-context-protocol, quest, skills, vr

## Install

```sh
git clone https://github.com/meta-quest/agentic-tools /tmp/agentic-tools && ln -s /tmp/agentic-tools/skills/hz-xr-simulator-control ~/.claude/skills/hz-xr-simulator-control
```

## From README

XR Simulator Control metavr is overwhelmingly a physical Quest or Glasses CLI: device, app, capture, input, log, files and ui all talk to a headset over ADB. xrsim is one group among them and drives a simulated headset instead. Choosing the wrong group is the most common failure here, and it is quiet: metavr device list prints No devices connected and exits 0, so the wrong answer looks healthier than the right one. This skill drives a simulator that already exists. Installing one, or wiring it into a project, belongs to hz-xr-simulator- -and-configure.

## Links

- HTML page: https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-xr-simulator-control/
- GitHub: https://github.com/meta-quest/agentic-tools
- Author: [@meta-quest](https://omgskills.com/library/meta-quest/index.md)

## More from this repo

- [hz-android-2d-porting](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-android-2d-porting/index.md) — Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars
- [hz-immersive-designer](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-immersive-designer/index.md) — Guides design of comfortable, intuitive VR/MR experiences for Meta VR and Horizon OS — comfort guidelines, interaction...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars
- [hz-iwsdk-webxr](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-iwsdk-webxr/index.md) — Builds WebXR experiences for Meta VR and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars