Build, test, launch and screenshot an iOS app on a Mac with Xcode. Use when a task asks to compile an Xcode project or Swift package for iOS, run unit or UI tests on an iOS Simulator, reproduce a crash, check a screen visually, or attach Simulator screenshots and test results to a pull request. Works on a local Mac or a hosted Mac such as a Macswarm Pod.
npx mdskills install MacSwarm/ios-build-and-testRelated
A skill and two templates that teach Claude Code and Codex to build, test, launch and screenshot iOS apps on a Mac with Xcode. They work on any Mac with Xcode: your own, a CI machine, or a Macswarm Pod.
| Path | What it is |
|---|---|
skills/ios-build-and-test/SKILL.md | Steps and commands for the agent: find the scheme, pick a Simulator by UDID, build, test with a result bundle, launch, screenshot, report |
templates/AGENTS.md | Instructions to commit at the root of an iOS repository: scheme, test plan, how to prove a change, how to work next to other agents on one Mac |
templates/CLAUDE.md | One line, @AGENTS.md, so Claude Code reads the same file as Codex |
/plugin marketplace add macswarm/ios-agent-kit
/plugin install ios-agent-kit@macswarm
Or copy the skill into a repository:
mkdir -p .claude/skills
cp -R skills/ios-build-and-test .claude/skills/
Codex loads skills from .agents/skills in the repository, or from ~/.agents/skills for every repository (Codex docs).
mkdir -p .agents/skills
cp -R skills/ios-build-and-test .agents/skills/
cp templates/AGENTS.md templates/CLAUDE.md /path/to/your-ios-repo/
Fill in the brackets in AGENTS.md and commit both files.
.xcworkspace, an .xcodeproj or a Package.swift.The skill never installs Xcode, changes signing or erases Simulators. It writes derived data, result bundles and screenshots under .build/.
Macswarm Pods come with the Latest Xcode, iOS runtimes, pre-booted Simulators, XcodeBuildMCP, Claude Code and Codex, and run 2 to 3 agents at once in separate git worktrees. See the quickstarts for Claude Code and Codex. The Free plan has 3 Pod-hours.
Issues and pull requests are welcome. Keep commands to what ships with Xcode, and test any change on a Simulator before you open the PR.
Mac, macOS, Xcode, and iOS Simulator are trademarks of Apple Inc. Macswarm is not affiliated with or endorsed by Apple. Claude and Claude Code are trademarks of Anthropic; Codex is a trademark of OpenAI.
Install via CLI
npx mdskills install MacSwarm/ios-build-and-testios-build-and-test is a free, open-source AI agent skill. Build, test, launch and screenshot an iOS app on a Mac with Xcode. Use when a task asks to compile an Xcode project or Swift package for iOS, run unit or UI tests on an iOS Simulator, reproduce a crash, check a screen visually, or attach Simulator screenshots and test results to a pull request. Works on a local Mac or a hosted Mac such as a Macswarm Pod.
Install ios-build-and-test with a single command:
npx mdskills install MacSwarm/ios-build-and-testThis downloads the skill files into your project and your AI agent picks them up automatically.
ios-build-and-test works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Codex, Gemini Cli, Amp, Roo Code, Goose, Opencode, Trae, Qodo, Command Code. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.