# hz-xr-simulator-install-and-configure

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

Installs and configures the Meta XR Simulator for testing Meta VR and Horizon OS apps without a physical device. Use when installing the simulator or integrating it with Unity, Unreal, or native OpenXR projects. For controlling a running simulator, use hz-xr-simulator-control. Build paths: Unity, Unreal, and native OpenXR; route Standard Android, Meta Spatial SDK, and WebXR work through hz-quest-verify-first.

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-install-and-configure ~/.claude/skills/hz-xr-simulator-install-and-configure
```

## From README

Meta XR Simulator and Configuration When to Use This Skill You need to test a Meta VR application without a physical headset connected You want rapid iteration during development without deploying to device each time You are setting up CI/CD pipelines that need automated testing of Meta VR apps You want to validate core interactions, UI, and locomotion before deploying to hardware What is Meta XR Simulator Meta XR Simulator is a desktop tool that simulates a Meta VR environment on your development machine. It intercepts the OpenXR runtime calls your application makes and provides simulated headset tracking, controller input, hand tracking, and environment data, allowing you to run and test VR/MR applications directly in your engine's editor or as standalone desktop builds. The simulator does not replicate Meta VR hardware performance. It runs on your desktop GPU and CPU. Its purpose is functional testing, not performance profiling.

## Links

- HTML page: https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-xr-simulator-install-and-configure/
- 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