AVP Builder

Deploy visionOS apps to your Apple Vision Pro entirely from the command line using Claude Code.

Clone a repo, build it, and install it on your headset -- or create a native volumetric RealityKit app from scratch -- without ever opening Xcode's project editor.

What's in this repo

File	What it does
CLAUDE.md	Drop-in project instructions for Claude Code. Put this in your working directory and Claude Code knows how to build and deploy to your AVP.
CLAUDE_TO_AVP.md	Step-by-step technical reference for the entire pipeline: pairing, signing, building, deploying, and troubleshooting.
SKILL.md	The full guide -- prerequisites, one-time setup, how it works, building from scratch, common pitfalls, and tested apps. Start here.

Quick start

1. One-time setup -- pair your AVP, enable Developer Mode, trust the cert. See SKILL.md for details.

2. Copy CLAUDE.md into an empty working directory.

3. Tell Claude Code what you want:

   "Clone dougholland/Cubes from GitHub, build it, and deploy it to my Apple Vision Pro."

   Claude Code handles cloning, signing, building, and wireless deployment.

4. Or build from scratch:

   "Build me a volumetric app that shows a 3D Earth with live satellite cloud data."

   Claude Code will generate a complete RealityKit project, build it, and deploy it.

Requirements

Component	Required
Mac with Xcode	Yes
Apple Developer Program ($99/year)	No -- free Apple ID works
USB cable	No -- AVP is wireless only
Wearing the headset	Only for initial pairing and certificate trust
Xcode GUI	Only for Devices & Simulators window during pairing
Claude Code	Yes

How it works

Claude Code automates every stage after the one-time device pairing:

1. Clone a visionOS project from GitHub
2. Configure signing, bundle IDs, and deployment targets
3. Build targeting your physical device (not the simulator)
4. Deploy wirelessly over Wi-Fi
5. Create from scratch -- generate native volumetric apps with no template

The only steps requiring the headset are pairing and trusting the developer certificate.

Tested apps

App	Source	Description
World	bitrise-io/sample-apps-visionOS-HelloWorld	Apple's "World" sample -- globe and solar system
Cubes	dougholland/Cubes	RealityKit demo with 3D objects, shadows, and collisions
WebEarth	Built from scratch	Volumetric 3D Earth with live satellite cloud data

License

MIT

---

Built with Claude Code.