using-xcode-cli

A Claude Code skill for building and managing iOS/macOS apps using native Xcode CLI tools (xcodebuild, xcrun simctl).

What This Skill Does

Teaches Claude to work with Xcode projects through direct command-line interfaces:

• Build apps for iOS simulators, devices, and macOS
• Manage simulators (boot, shutdown, create, erase)
• Install and launch apps in simulators
• Capture screenshots and record video
• Run tests (unit and UI tests)
• Stream logs from running apps

Installation

Option 1: Direct Git Installation

/plugin install --git https://github.com/bradwindy/using-xcode-cli-skill

Option 2: Marketplace Installation

First add the marketplace:

/plugin marketplace add bradwindy/using-xcode-cli-skill

Then install the plugin:

/plugin install using-xcode-cli@using-xcode-cli-marketplace

Option 3: Local Development

git clone https://github.com/bradwindy/using-xcode-cli-skill.git
/plugin marketplace add ./using-xcode-cli-skill
/plugin install using-xcode-cli@using-xcode-cli-marketplace

Requirements

• macOS with Xcode installed
• Claude Code CLI
• jq (optional, for JSON parsing)

Usage

The skill activates automatically when you ask about:

• Building Xcode projects
• Running apps in simulators
• Managing iOS/macOS simulators
• Taking screenshots
• Running tests

Example Prompts

• "Build the app for iPhone 16 Pro simulator"
• "List all available simulators"
• "Take a screenshot of the running simulator"
• "Run the unit tests for the App scheme"

Structure

skills/using-xcode-cli/
├── SKILL.md                    # Main skill instructions
└── reference/
    ├── xcodebuild.md           # Build and test commands
    ├── simctl.md               # Simulator management
    ├── logging.md              # Log streaming
    └── workflows.md            # Complete automation scripts

License

MIT

Credits

Based on xcode-build-skill by pzep1.