# Run App

> Build and launch the iOS app on a simulator. Use when you need to run the app for manual testing or demonstration.

- Skill: `duboc/run-app` (Agent Skill)
- Install (CLI): `npx skillmds@latest add duboc/run-app`
- Raw SKILL.md: https://api.skillmd.com/api/skills/duboc/run-app/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: duboc (https://skillmd.com/u/duboc)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/duboc/run-app

---


# Run App on Simulator

Build and launch the app on an iOS Simulator.

## Workflow

### 1. Build the App
```bash
xcodebuild -scheme MyApp \
  -destination 'platform=iOS Simulator,name=iPhone 15' \
  -derivedDataPath build \
  build
```

### 2. Boot Simulator (if needed)
```bash
# List available simulators
xcrun simctl list devices

# Boot a specific simulator
xcrun simctl boot "iPhone 15"
```

### 3. Install App
```bash
xcrun simctl install "iPhone 15" \
  build/Build/Products/Debug-iphonesimulator/MyApp.app
```

### 4. Launch App
```bash
xcrun simctl launch "iPhone 15" com.mycompany.MyApp
```

## Combined Command
```bash
# Open simulator and run
open -a Simulator && \
xcodebuild -scheme MyApp \
  -destination 'platform=iOS Simulator,name=iPhone 15' \
  -derivedDataPath build \
  build && \
xcrun simctl install booted build/Build/Products/Debug-iphonesimulator/MyApp.app && \
xcrun simctl launch booted com.mycompany.MyApp
```

## Useful Simulator Commands

### Take Screenshot
```bash
xcrun simctl io booted screenshot screenshot.png
```

### Record Video
```bash
xcrun simctl io booted recordVideo video.mp4
```

### Open URL
```bash
xcrun simctl openurl booted "myapp://deep-link"
```

### Clear App Data
```bash
xcrun simctl uninstall booted com.mycompany.MyApp
```

### Reset Simulator
```bash
xcrun simctl erase "iPhone 15"
```