test-xcode

Build and test iOS apps on simulators to detect build failures and runtime crashes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/xbpk3t/ce-codex --skill test-xcode-xbpk3t
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-xcode
Source: https://github.com/xbpk3t/ce-codex/tree/main/skills/test-xcode
Command: npx skills add https://github.com/xbpk3t/ce-codex --skill test-xcode-xbpk3t

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects build failures, runtime crashes, and UI regressions that are hard to catch without running an app on an iOS simulator by automating the build, install, launch, and verification steps so issues are discovered before creating a PR.

Core Features & Use Cases

  • Build and Install: Discover Xcode projects and schemes, build the app for the simulator, and install the built app onto a chosen simulator.
  • Automated Diagnostics: Boot simulators, capture screenshots, stream and collect console logs, detect crashes or error-level messages, and create prioritized todos for build or runtime failures.
  • Human-in-the-loop Verification: Pause for manual interactions for flows that require user input (Sign in with Apple, in-app purchases, camera permissions) and provide clear prompts for verification.
  • Use Case: Run after iOS code changes or as part of PR review to reproduce crashes, validate key screens, and generate actionable reports and todos for failures.

Quick Start

Run the test-xcode skill to build the default scheme on a simulator, capture screenshots and logs, and report any build or runtime failures.

Frequently Asked Questions about test-xcode

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate iOS simulator builds and tests to catch runtime crashes?

You can automate iOS simulator builds and tests by discovering Xcode schemes, building the app, installing it on a booted simulator, and capturing screenshots and logs to detect build failures and runtime crashes.

How do I capture screenshots and stream console logs during an iOS simulator test?

To capture screenshots and stream console logs during an iOS simulator test, you boot a chosen simulator, install and launch the app, and collect console logs to detect error-level messages and crashes.

Do I need an XcodeBuildMCP server to run iOS simulator tests and capture screenshots?

Yes, you need a connected XcodeBuildMCP server, Xcode command-line tools, and at least one available iOS simulator to support screenshot capture, log streaming, installation, and launch flows.

Can I automate PR verification for iOS apps to detect UI regressions?

You can automate PR verification for iOS apps by building and launching the app on a simulator to reproduce crashes, validate key screens via screenshots, and generate actionable reports for failures.

How do I handle human verification steps like in-app purchases during automated iOS testing?

Automated iOS testing handles human verification steps by pausing for manual interactions for flows requiring user input, such as Sign in with Apple or camera permissions, and providing clear prompts for verification.

What are the limitations of automating Xcode project builds for simulator testing?

A limitation of automating Xcode project builds is that flows requiring manual user input cannot be fully automated, requiring human-in-the-loop verification to pause testing and prompt for manual interaction.