xcode-run-device
Installation
SKILL.md
Build + run on a connected iOS device
Build the Xcode workspace or project under the current working directory and launch it on a wired-connected iOS device via Xcode 15+ devicectl. Requires a configured signing team in the project and a trusted, paired device.
How to run
The shared agent-skill-xcode.el lives in the sibling xcode-shared directory at skills/xcode-shared/agent-skill-xcode.el in the emacs-skills plugin. All four /xcode-* skills load it from there.
emacsclient --eval "(progn (load \"/path/to/skills/xcode-shared/agent-skill-xcode.el\" nil t) (agent-skill-xcode-run-device :project-dir \"$(pwd)\"))"
The function:
- Locates the workspace/project and picks a scheme.
- Locates the first connected device via
xcrun devicectl list devices -j. - Runs
xcodebuild buildagainst the device's specific UDID. - Reads
BUILT_PRODUCTS_DIR/WRAPPER_NAME/PRODUCT_BUNDLE_IDENTIFIERfrom-showBuildSettings -json. - Installs (
xcrun devicectl device install app) and launches (xcrun devicectl device process launch). - Returns a multi-line status string. On build failure, returns the same error format as
/xcode-build-device.