xcuitest

XCUITest Command

This command invokes the xcuitest-runner agent to generate, maintain, and execute end-to-end UI tests for iOS apps.

What This Command Does

1. Generate Test Journeys - Create XCUITest tests for user flows
2. Run UI Tests - Execute tests on simulators/devices
3. Capture Artifacts - Screenshots, videos on failures
4. Manage Flaky Tests - Quarantine unstable tests
5. Generate Reports - xcresult bundles for analysis

When to Use

Use /xcuitest when:

• Testing critical user journeys (login, onboarding, payments)
• Verifying multi-step flows work end-to-end
• Testing UI interactions and navigation
• Validating accessibility
• Preparing for App Store submission
• Testing push notification handling

How It Works

The xcuitest-runner agent will:

1. Analyze user flow and identify test scenarios
2. Generate XCUITest using Page Object Model (Screen Objects)
3. Set up accessibility identifiers if missing
4. Run tests on specified simulators
5. Capture failures with screenshots and videos
6. Generate report with results and artifacts

Example Usage

User: /xcuitest Test the login and home flow

Agent (xcuitest-runner):
# E2E Test Generation: Login to Home Flow

## Test Scenario Identified

**User Journey:** Launch → Login → Home Screen

**Test Coverage:**
1. App launches successfully
2. Login screen appears
3. Enter credentials
4. Tap login button
5. Home screen loads
6. User name displayed

## Generated Screen Objects

```swift
// UITests/Screens/LoginScreen.swift
import XCTest

final class LoginScreen {
    private let app: XCUIApplication

    init(app: XCUIApplication) {
        self.app = app
    }

    // MARK: - Elements
    var emailField: XCUIElement { app.textFields["email-field"] }
    var passwordField: XCUIElement { app.secureTextFields["password-field"] }
    var loginButton: XCUIElement { app.buttons["login-button"] }
    var errorLabel: XCUIElement { app.staticTexts["error-label"] }