Automate building, testing, and archiving Swift packages and Xcode projects for Apple platforms. Integrates with Claude Code to streamline iOS, iPadOS, macOS, tvOS, watchOS, and visionOS development workflows. Connects to Xcode and xcodebuild for efficient CI/CD pipelines.
git clone https://github.com/kylehughes/apple-platform-build-tools-claude-code-plugin.gitApple Platform Build Tools Claude Code Plugin provides reference documentation and automated execution for building Swift packages and Xcode projects targeting iOS, iPadOS, macOS, tvOS, watchOS, and visionOS. It includes an Agent Skill with detailed xcrun tool documentation and a Subagent that discovers project structure, manages simulators and devices, runs builds, and returns results without cluttering the main agent's context. Teams can delegate build and test commands to the Subagent or reference the Agent Skill directly for complex xcodebuild commands, code signing, profiling, distribution, and troubleshooting. The plugin integrates with CI/CD workflows and supports physical device deployment, binary inspection, and performance profiling through xctrace and xcresulttool.
[{"step":"Install the plugin in Claude Code","action":"Run `claude plugins install apple-platform-build-tools-claude-code-plugin` in your terminal. Ensure Xcode and the Command Line Tools are installed."},{"step":"Configure the project","action":"Open the project in Xcode and verify the scheme settings. Ensure the scheme is shared and the build settings are correct for your target platform (e.g., iOS, macOS)."},{"step":"Run the build or test command","action":"Use the plugin to execute a command like `claude build --platform ios --device simulator --clean` or `claude test --platform macos --scheme MyMacApp`."},{"step":"Review the output and artifacts","action":"Check the build logs for errors or warnings. Verify the generated archive or test results. Use the provided summary to identify next steps."},{"step":"Integrate with CI/CD (optional)","action":"Configure the plugin in your CI/CD pipeline (e.g., GitHub Actions, Bitrise) to automate builds, tests, and archives. Use environment variables for dynamic configurations."}]
Automating CI/CD pipelines for iOS and macOS app builds on GitHub Actions
Managing simulator lifecycle and deploying to physical devices from Claude Code
Constructing complex xcodebuild commands for code signing and distribution
Running tests with filtering and coverage analysis across Apple platforms
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/kylehughes/apple-platform-build-tools-claude-code-pluginCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Use the apple-platform-build-tools-claude-code-plugin to [ACTION] the [TARGET] project. [SPECIFIC_TASK]. Ensure the build completes successfully and generate a summary of the output. Example: 'Use the apple-platform-build-tools-claude-code-plugin to build and test the MyApp iOS project for iPhone 15 simulator. Run unit tests and archive the build for distribution.'
### Build and Test Summary for MyApp (iOS) **Build Status**: ✅ Success - Target: MyApp (iOS 17.4) - Device: iPhone 15 Simulator (iOS 17.4) - Xcode Version: 15.3 (15E204a) - Build Duration: 4m 22s **Test Results**: - Total Tests: 128 - Passed: 128 (100%) - Failed: 0 - Skipped: 0 **Warnings**: 3 (all resolved in subsequent builds) - Deprecation warnings for UIKit APIs marked for removal in iOS 18 - Minor memory leaks in networking layer (flagged for future optimization) **Archive Details**: - Archive Path: `/Users/dev/MyApp/Builds/MyApp_2024-05-15.xcarchive` - Export Method: App Store Distribution - Provisioning Profile: `AppStore_MyApp_2024` - Entitlements: Push Notifications, iCloud, HealthKit **Next Steps**: 1. Upload the archive to App Store Connect via Transporter. 2. Review TestFlight feedback from internal testers. 3. Address deprecation warnings in the next sprint. **Log Output**: ``` [14:32:22] Building for iOS Simulator... (Debug) [14:36:44] Compiling Swift sources... [14:38:12] Linking MyApp... (100%) [14:39:01] Running tests... [14:42:15] All tests passed! [14:43:00] Archiving for distribution... ```
AI assistant built for thoughtful, nuanced conversation
IronCalc is a spreadsheet engine and ecosystem
ITIL-aligned IT service management platform
Customer feedback management made simple
Enterprise workflow automation and service management platform
Automate your spreadsheet tasks with AI power
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan