Run on a Physical Device (CLI)

Builds, signs, installs, and launches an app on a connected physical device straight from the terminal — no Xcode Run button. The companion run-simulator skill covers the Simulator; this is the hardware path, which uses a different toolchain: devicectl (not simctl), real code signing, and an external tool for screenshots.

Building proves the code typechecks and signs; launching proves it installs and runs on real hardware. A crash on launch or a failed install is a failure.

When This Skill Activates

Use when the user wants to:

• Run / test their app on a real iPhone or iPad from the CLI
• Install a build on a device without opening Xcode
• Reproduce a device-only bug (camera, sensors, performance, push)
• Screenshot the app running on hardware