skills/install/SKILL.md
Build, install, and launch the app on the simulator using Grantiva. Use when you need the full build-install-launch cycle, mirroring what CI does. Prefer this over build when you want the app running immediately after compilation.
npx skillsauth add grantiva/swift-assist installInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Build, install, and launch the app on the simulator using Grantiva. This mirrors the full CI flow. Use this when you want the app running and ready for testing immediately after a code change.
The difference from /swift-assist:build: build compiles only. install compiles, installs on the simulator, and launches the app.
/swift-assist:install
/swift-assist:install --scheme=MyApp
/swift-assist:install --scheme=MyApp --simulator="iPhone 16 Pro"
--scheme=<name>: Xcode scheme to build (reads from grantiva.yml if omitted)--simulator=<name>: Target simulator (reads from grantiva.yml if omitted)Load scheme and simulator from grantiva.yml if not provided via arguments:
cat grantiva.yml
If grantiva.yml doesn't exist, tell the user to run /swift-assist:init first.
Use Grantiva to build, install, and launch:
grantiva install
This resolves the project, boots the simulator if needed, builds the app, installs it, and launches it - mirroring the CI flow.
Start the Grantiva runner so the hierarchy and doctor commands can inspect the app:
grantiva runner start --bundle-id <BUNDLE_ID> --simulator "<SIMULATOR>"
Install complete.
Scheme: <SCHEME>
Simulator: <SIMULATOR>
Bundle ID: <BUNDLE_ID>
App is running. Run /swift-assist:doctor to audit or /swift-assist:test to run flows.
.app path exists before attempting to installtesting
Run visual regression testing using Grantiva's diff pipeline. Capture screenshots, compare against baselines, and report visual differences. Use for catching unintended UI changes.
testing
Approve current VRT captures as new baselines. Can approve all or specific screens selectively. Use after reviewing /swift-assist:vrt results.
testing
Run generated test flows against the app in the simulator using Grantiva. Use after /swift-assist:make-tests to execute and validate your user flows.
development
Add the UI_TESTING / .mock services pattern to the app entry point so Grantiva can run tests with deterministic data and no live server. Use before make-tests when the app talks to an API.