ios-unit-test

name	ios-unit-test
description	Run iOS unit/UI tests, report results, and optionally fix failures.
argument-hint	[--scheme <name>] [--project <path>] [--configuration NonProd|Prod] [--no-fix]
allowed-tools	Bash, Read, Glob, Grep, Write

Purpose

Run iOS tests, report failures with enough detail to debug, then (with approval) fix issues and re-run to confirm.

Arguments

• --scheme <name> — Xcode scheme (inferred from xcodebuild -list if omitted)
• --project <path> — Path to .xcodeproj or .xcworkspace (auto-detected if omitted)
• --configuration <config> — Build configuration (default: NonProd)
• --no-fix — Report only, don't offer to fix

Workflow

1. Run tests

xcodebuild \
  -project MyApp.xcodeproj \
  -scheme MyApp \
  -configuration NonProd \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro' \
  test

Use xcodebuild -list to discover schemes if not specified. Simulator names vary by Xcode version — use xcrun simctl list devices available to find available simulators.

Note: Tests use Swift Testing framework (import Testing, @Test, ), not XCTest.