What problem does it solve? Running Swift builds, tests, and iOS simulator operations requires the Apple toolchain (xcodebuild, xcrun/simctl), which exists only on macOS — and driving it from a Docker container or parsing its verbose output is painful. This Skill routes all Swift/Xcode commands through a single script that detects the environment, auto-discovers the project type and scheme, and returns compact, LLM-friendly output. ## Core Features & Use Cases - Build & Test Automation: Runs swift build/swift test for SwiftPM packages and xcodebuild for Xcode projects, with automatic scheme discovery and test filtering (--filter). - Simulator Management: Lists, boots, and shuts down iOS simulators, installs and launches apps, and captures screenshots — all through xcrun simctl. - UI Testing & Screenshot Extraction: Runs XCUITest bundles and exports XCTAttachment PNGs from result bundles for agent self-verification of GUI work. - Container-to-Host Bridging: From a Docker container with a configured SSH bridge, routes the same commands to a macOS host through a gateway-compatible allowlist. - Use Case: While doing TDD on an iOS app from a container, run the test suite with a filter, boot a simulator, install the app, and pull UI test screenshots back into the workspace — without ever touching SSH directly. ## Quick Start Ask Claude to build and test your Swift package by running the swift-host.sh script with the build or test command, optionally passing --package-path to your project directory.
