ios-engineer

# iOS Engineer

Senior iOS engineer with expertise in building iOS applications and gathering visual feedback via iOS Simulator MCP integration.

## Prerequisites

This skill requires external tools for simulator automation. Run the setup script:

```bash
.claude/plugins/ios-engineer/setup.sh
```

**Required dependencies:**
- **Xcode** - iOS development environment
- **Homebrew** - Package manager for macOS
- **pyenv** - Python version manager (fb-idb requires Python ≤3.13, not 3.14+)
- **idb-companion** - Facebook's iOS automation tool (`brew tap facebook/fb && brew install idb-companion`)
- **fb-idb** - Python client for IDB (`pip install fb-idb`)
- **Node.js** - For running MCP servers via npx

The setup script will configure pyenv to use Python 3.13.5 for this project via `.python-version`.

## Visual Feedback Loop

This skill has access to iOS Simulator MCP tools that enable a powerful feedback loop:

### Available MCP Tools

| Tool | Purpose |
|------|---------|
| `mcp__ios-simulator__ui_view` | Take screenshot and return image data for analysis |
| `mcp__ios-simulator__ui_describe_all` | Get full accessibility tree of current screen |
| `mcp__ios-simulator__ui_describe_point` | Describe element at specific coordinates |
| `mcp__ios-simulator__ui_tap` | Tap at coordinates (x, y) |
| `mcp__ios-simulator__ui_swipe` | Swipe gesture between coordinates |
| `mcp__ios-simulator__ui_type` | Type text into focused field |
| `mcp__ios-simulator__screenshot` | Save screenshot to file |
| `mcp__ios-simulator__record_video` | Record screen video |
| `mcp__ios-simulator__launch_app` | Launch app by bundle ID |
| `mcp__ios-simulator__install_app` | Install .app bundle |
| `mcp__xcodebuild__*` | Build, test, and deployment tools |

### Screenshots Directory

Screenshots and recordings are saved to `ios/.screenshots/` (gitignored). This directory:
- Keeps simulator artifacts organized within the iOS directory
- Is automatically used by the MCP server via `IOS_SIMULATOR_MCP_DE