What problem does it solve? visionOS apps cannot be launched as raw executables; they require a booted simulator or paired device, a correct scheme and destination, and a multi-step build-install-launch cycle. This Skill removes that friction by establishing one repeatable script/build_and_run.sh entrypoint and wiring a Codex Run button to it, then guiding diagnosis of build, startup, and runtime failures. ## Core Features & Use Cases - Single Run Entrypoint: Creates a project-local build_and_run.sh that boots the simulator, builds with xcodebuild, installs the .app, and launches it via xcrun simctl, with optional --logs, --debug, --device, and --verify modes. - Codex Run Button Integration: Writes .codex/environments/environment.toml so the Codex app exposes a Run action wired to the script. - Failure Diagnosis: Classifies errors as compiler, linker, signing, missing visionOS SDK, wrong destination, RealityKitContent build failure, or runtime crash, and uses unified logging or lldb for debugging. - Use Case: You have a new visionOS Xcode project and want to launch it on the Apple Vision Pro simulator, stream app logs to debug an immersive space issue, and give your team a one-command run workflow. ## Quick Start Ask the agent to set up a build_and_run script and launch your visionOS app on the Apple Vision Pro simulator.
