Skip to content

BumpyClock/agent-templates / skills/ios-macos-development

ios-macos-development

Unverified

Build, debug, or release iOS and macOS apps with Swift and Apple platform tools.

FileKindSize
SKILL.mdskill md2.1 KB
agents/openai.yamlconfig278 B
app-store-connect-cli/asc-app-create-ui/guide.mdmarkdown6.3 KB
app-store-connect-cli/asc-build-lifecycle/guide.mdmarkdown1.8 KB
app-store-connect-cli/asc-cli-usage/guide.mdmarkdown1.3 KB
app-store-connect-cli/asc-id-resolver/guide.mdmarkdown1.3 KB
app-store-connect-cli/asc-metadata-sync/guide.mdmarkdown4.5 KB
app-store-connect-cli/asc-notarization/guide.mdmarkdown7.2 KB
app-store-connect-cli/asc-ppp-pricing/guide.mdmarkdown4.4 KB
app-store-connect-cli/asc-release-flow/guide.mdmarkdown4.7 KB
app-store-connect-cli/asc-shots-pipeline/guide.mdmarkdown10.7 KB
app-store-connect-cli/asc-signing-setup/guide.mdmarkdown2.6 KB
app-store-connect-cli/asc-submission-health/guide.mdmarkdown6.9 KB
app-store-connect-cli/asc-subscription-localization/guide.mdmarkdown10.2 KB
app-store-connect-cli/asc-testflight-orchestration/guide.mdmarkdown1.7 KB
app-store-connect-cli/asc-workflow/guide.mdmarkdown5.3 KB
app-store-connect-cli/asc-xcode-build/guide.mdmarkdown3.7 KB
app-store-connect-cli/guide.mdmarkdown3.6 KB
instruments-profiling/guide.mdmarkdown3.7 KB
ios-app-intents/guide.mdmarkdown4.8 KB
ios-app-intents/references/code-templates.mdmarkdown7.4 KB
ios-app-intents/references/example-patterns.mdmarkdown3.6 KB
ios-app-intents/references/first-pass-checklist.mdmarkdown1.4 KB
ios-app-intents/references/system-surfaces.mdmarkdown1.0 KB
ios-debugger-agent/guide.mdmarkdown2.7 KB
ios-simulator/guide.mdmarkdown21.0 KB
ios-simulator/references/accessibility_checklist.mdmarkdown1.5 KB
ios-simulator/references/idb_quick.mdmarkdown1.1 KB
ios-simulator/references/simctl_quick.mdmarkdown1.3 KB
ios-simulator/references/test_patterns.mdmarkdown1.6 KB
ios-simulator/references/troubleshooting.mdmarkdown1.3 KB
ios-simulator/scripts/accessibility_audit.pyexecutablescript10.3 KB
ios-simulator/scripts/app_launcher.pyexecutablescript9.7 KB
ios-simulator/scripts/app_state_capture.pyexecutablescript13.2 KB
ios-simulator/scripts/appearance.pyscript11.3 KB
ios-simulator/scripts/build_and_test.pyexecutablescript11.3 KB
ios-simulator/scripts/clipboard.pyscript2.6 KB
ios-simulator/scripts/common/__init__.pyscript1.5 KB
ios-simulator/scripts/common/cache_utils.pyscript9.3 KB
ios-simulator/scripts/common/device_utils.pyscript13.5 KB
ios-simulator/scripts/common/env_config.pyscript1.1 KB
ios-simulator/scripts/common/hang_pipeline.pyscript29.6 KB
ios-simulator/scripts/common/hang_sessions.pyscript17.9 KB
ios-simulator/scripts/common/idb_utils.pyscript5.3 KB
ios-simulator/scripts/common/screenshot_utils.pyscript10.0 KB
ios-simulator/scripts/container.pyscript22.7 KB
ios-simulator/scripts/gesture.pyexecutablescript12.3 KB
ios-simulator/scripts/hang_watcher.pyscript56.5 KB
ios-simulator/scripts/keyboard.pyexecutablescript11.5 KB
ios-simulator/scripts/localization_audit.pyscript16.2 KB
ios-simulator/scripts/location.pyscript15.4 KB
ios-simulator/scripts/log_monitor.pyexecutablescript14.8 KB
ios-simulator/scripts/model_inspector.pyscript21.7 KB
ios-simulator/scripts/navigator.pyexecutablescript14.2 KB
ios-simulator/scripts/privacy_manager.pyscript8.7 KB
ios-simulator/scripts/push_notification.pyscript6.5 KB
ios-simulator/scripts/screen_mapper.pyexecutablescript10.7 KB
ios-simulator/scripts/sim_health_check.shscript8.1 KB
ios-simulator/scripts/sim_list.pyscript8.9 KB
ios-simulator/scripts/simctl_boot.pyexecutablescript9.1 KB
ios-simulator/scripts/simctl_create.pyexecutablescript8.9 KB
ios-simulator/scripts/simctl_delete.pyexecutablescript10.3 KB
ios-simulator/scripts/simctl_erase.pyexecutablescript10.2 KB
ios-simulator/scripts/simctl_shutdown.pyexecutablescript8.4 KB
ios-simulator/scripts/simulator_selector.pyexecutablescript10.3 KB
ios-simulator/scripts/status_bar.pyscript6.6 KB
ios-simulator/scripts/test_recorder.pyexecutablescript10.6 KB
ios-simulator/scripts/visual_diff.pyexecutablescript7.6 KB
ios-simulator/scripts/xcode/__init__.pyscript378 B
ios-simulator/scripts/xcode/builder.pyscript13.2 KB
ios-simulator/scripts/xcode/cache.pyscript5.5 KB
ios-simulator/scripts/xcode/config.pyscript5.4 KB
ios-simulator/scripts/xcode/reporter.pyscript10.7 KB
ios-simulator/scripts/xcode/xcresult.pyscript16.5 KB
native-app-performance/attribution.txtmarkdown349 B
native-app-performance/guide.mdmarkdown2.1 KB
native-app-performance/scripts/extract_time_samples.pyscript1.1 KB
native-app-performance/scripts/record_time_profiler.shscript1.3 KB
native-app-performance/scripts/top_hotspots.pyscript4.0 KB
swift-concurrency-expert/attribution.txtmarkdown353 B
swift-concurrency-expert/guide.mdmarkdown1.9 KB
swift-concurrency-expert/references/swift-6-2-concurrency.mdmarkdown4.3 KB
swift-concurrency-expert/references/swiftui-concurrency-tour-wwdc.mdmarkdown1.6 KB
swift-ui/guide.mdmarkdown1.0 KB
swift-ui/references/index.mdmarkdown4.2 KB
swift-ui/references/liquid-glass/appkit.mdmarkdown3.3 KB
swift-ui/references/liquid-glass/overview.mdmarkdown1.6 KB
swift-ui/references/liquid-glass/patterns.mdmarkdown3.9 KB
swift-ui/references/liquid-glass/swiftui.mdmarkdown4.0 KB
swift-ui/references/logging-private-fix.mdmarkdown8.0 KB
swift-ui/references/modern-swift.mdmarkdown2.9 KB
swift-ui/references/swift-concurrency.mdmarkdown39.6 KB
swift-ui/references/swift-testing-playbook.mdmarkdown35.3 KB
swift-ui/references/swiftui.mdmarkdown1.8 MB
swift-ui/references/toolbar/swiftui-features.mdmarkdown4.7 KB
swiftui-liquid-glass/attribution.txtmarkdown345 B
swiftui-liquid-glass/guide.mdmarkdown4.1 KB
swiftui-liquid-glass/references/liquid-glass.mdmarkdown8.0 KB
swiftui-performance-audit/attribution.txtmarkdown355 B
swiftui-performance-audit/guide.mdmarkdown1.7 KB
swiftui-performance-audit/references/code-smells.mdmarkdown4.8 KB
swiftui-performance-audit/references/demystify-swiftui-performance-wwdc23.mdmarkdown1.8 KB
swiftui-performance-audit/references/optimizing-swiftui-performance-instruments.mdmarkdown1.8 KB
swiftui-performance-audit/references/profiling-intake.mdmarkdown2.4 KB
swiftui-performance-audit/references/report-template.mdmarkdown1.2 KB
swiftui-performance-audit/references/understanding-hangs-in-your-app.mdmarkdown1.2 KB
swiftui-performance-audit/references/understanding-improving-swiftui-performance.mdmarkdown2.2 KB
swiftui-ui-patterns/guide.mdmarkdown2.0 KB
swiftui-ui-patterns/references/app-wiring.mdmarkdown6.5 KB
swiftui-ui-patterns/references/async-state.mdmarkdown3.5 KB
swiftui-ui-patterns/references/components-index.mdmarkdown4.2 KB
swiftui-ui-patterns/references/controls.mdmarkdown1.6 KB
swiftui-ui-patterns/references/deeplinks.mdmarkdown1.7 KB
swiftui-ui-patterns/references/focus.mdmarkdown2.3 KB
swiftui-ui-patterns/references/form.mdmarkdown3.0 KB
swiftui-ui-patterns/references/grids.mdmarkdown1.8 KB
swiftui-ui-patterns/references/haptics.mdmarkdown2.0 KB
swiftui-ui-patterns/references/input-toolbar.mdmarkdown1.4 KB
swiftui-ui-patterns/references/lightweight-clients.mdmarkdown2.5 KB
swiftui-ui-patterns/references/list.mdmarkdown2.7 KB
swiftui-ui-patterns/references/loading-placeholders.mdmarkdown1.2 KB
swiftui-ui-patterns/references/macos-settings.mdmarkdown2.0 KB
swiftui-ui-patterns/references/matched-transitions.mdmarkdown1.6 KB
swiftui-ui-patterns/references/media.mdmarkdown2.0 KB
swiftui-ui-patterns/references/menu-bar.mdmarkdown2.2 KB
swiftui-ui-patterns/references/navigationstack.mdmarkdown4.2 KB
swiftui-ui-patterns/references/overlay.mdmarkdown1.2 KB
swiftui-ui-patterns/references/performance.mdmarkdown1.9 KB
swiftui-ui-patterns/references/previews.mdmarkdown1.6 KB
swiftui-ui-patterns/references/scroll-reveal.mdmarkdown5.2 KB
swiftui-ui-patterns/references/scrollview.mdmarkdown2.3 KB
swiftui-ui-patterns/references/searchable.mdmarkdown1.7 KB
swiftui-ui-patterns/references/sheets.mdmarkdown4.3 KB
swiftui-ui-patterns/references/split-views.mdmarkdown2.0 KB
swiftui-ui-patterns/references/tabview.mdmarkdown3.4 KB
swiftui-ui-patterns/references/theming.mdmarkdown1.7 KB
swiftui-ui-patterns/references/title-menus.mdmarkdown2.1 KB
swiftui-ui-patterns/references/top-bar.mdmarkdown1.3 KB
swiftui-view-refactor/guide.mdmarkdown1.6 KB
swiftui-view-refactor/references/mv-patterns.mdmarkdown2.3 KB

ios-simulator/scripts/xcode/builder.py

View on GitHub
"""
Xcode build execution.

Handles xcodebuild command construction and execution with xcresult generation.
"""

import re
import subprocess
import sys
from pathlib import Path

from common.env_config import env_int

from .cache import XCResultCache
from .config import Config

BUILD_TIMEOUT = env_int("IOS_SIM_BUILD_TIMEOUT", 1800)
TEST_TIMEOUT = env_int("IOS_SIM_TEST_TIMEOUT", 2700)
INTROSPECT_TIMEOUT = env_int("IOS_SIM_INTROSPECT_TIMEOUT", 60)


class BuildRunner:
    """
    Execute xcodebuild commands with xcresult bundle generation.

    Handles scheme auto-detection, command construction, and build/test execution.
    """

    def __init__(
        self,
        project_path: str | None = None,
        workspace_path: str | None = None,
        scheme: str | None = None,
        configuration: str = "Debug",
        simulator: str | None = None,
        cache: XCResultCache | None = None,
    ):
        """
        Initialize build runner.

        Args:
            project_path: Path to .xcodeproj
            workspace_path: Path to .xcworkspace
            scheme: Build scheme (auto-detected if not provided)
            configuration: Build configuration (Debug/Release)
            simulator: Simulator name
            cache: XCResult cache (creates default if not provided)
        """
        self.project_path = project_path
        self.workspace_path = workspace_path
        self.scheme = scheme
        self.configuration = configuration
        self.simulator = simulator
        self.cache = cache or XCResultCache()

    def auto_detect_scheme(self) -> str | None:
        """
        Auto-detect build scheme from project/workspace.

        Returns:
            Detected scheme name or None
        """
        cmd = ["xcodebuild", "-list"]

        if self.workspace_path:
            cmd.extend(["-workspace", self.workspace_path])
        elif self.project_path:
            cmd.extend(["-project", self.project_path])
        else:
            return None

        try:
            result = subprocess.run(
                cmd, capture_output=True, text=True, check=True, timeout=INTROSPECT_TIMEOUT
            )

            # Parse schemes from output
            in_schemes_section = False
            for line in result.stdout.split("\n"):
                line = line.strip()

                if "Schemes:" in line:
                    in_schemes_section = True
                    continue

                if in_schemes_section and line and not line.startswith("Build"):
                    # First scheme in list
                    return line

        except subprocess.CalledProcessError as e:
            print(f"Error auto-detecting scheme: {e}", file=sys.stderr)

        return None

    def get_simulator_destination(self) -> str:
        """
        Get xcodebuild destination string.

        Uses config preferences with fallback to auto-detection.

        Priority:
            1. --simulator CLI flag (self.simulator)
            2. Config preferred_simulator
            3. Config last_used_simulator
            4. Auto-detect first iPhone
            5. Generic iOS Simulator

        Returns:
            Destination string for -destination flag
        """
        # Priority 1: CLI flag
        if self.simulator:
            return f"platform=iOS Simulator,name={self.simulator}"

        # Priority 2-3: Config preferences
        try:
            # Determine project directory from project/workspace path
            project_dir = None
            if self.project_path:
                project_dir = Path(self.project_path).parent
            elif self.workspace_path:
                project_dir = Path(self.workspace_path).parent

            config = Config.load(project_dir=project_dir)
            preferred = config.get_preferred_simulator()

            if preferred:
                # Check if preferred simulator exists
                if self._simulator_exists(preferred):
                    return f"platform=iOS Simulator,name={preferred}"
                print(f"Warning: Preferred simulator '{preferred}' not available", file=sys.stderr)
                if config.should_fallback_to_any_iphone():
                    print("Falling back to auto-detection...", file=sys.stderr)
                else:
                    # Strict mode: don't fallback
                    return f"platform=iOS Simulator,name={preferred}"

        except Exception as e:
            print(f"Warning: Could not load config: {e}", file=sys.stderr)

        # Priority 4-5: Auto-detect
        return self._auto_detect_simulator()

    def _simulator_exists(self, name: str) -> bool:
        """
        Check if simulator with given name exists and is available.

        Args:
            name: Simulator name (e.g., "iPhone 16 Pro")

        Returns:
            True if simulator exists and is available
        """
        try:
            result = subprocess.run(
                ["xcrun", "simctl", "list", "devices", "available", "iOS"],
                capture_output=True,
                text=True,
                check=True,
                timeout=INTROSPECT_TIMEOUT,
            )

            # Check if simulator name appears in available devices
            return any(name in line and "(" in line for line in result.stdout.split("\n"))

        except subprocess.CalledProcessError:
            return False

    def _extract_simulator_name_from_destination(self, destination: str) -> str | None:
        """
        Extract simulator name from destination string.

        Args:
            destination: Destination string (e.g., "platform=iOS Simulator,name=iPhone 16 Pro")

        Returns:
            Simulator name or None
        """
        # Pattern: name=<simulator name>
        match = re.search(r"name=([^,]+)", destination)
        if match:
            return match.group(1).strip()
        return None

    def _auto_detect_simulator(self) -> str:
        """
        Auto-detect best available iOS simulator.

        Returns:
            Destination string for -destination flag
        """
        try:
            result = subprocess.run(
                ["xcrun", "simctl", "list", "devices", "available", "iOS"],
                capture_output=True,
                text=True,
                check=True,
                timeout=INTROSPECT_TIMEOUT,
            )

            # Parse available simulators, prefer latest iPhone
            # Looking for lines like: "iPhone 16 Pro (12345678-1234-1234-1234-123456789012) (Shutdown)"
            for line in result.stdout.split("\n"):
                if "iPhone" in line and "(" in line:
                    # Extract device name
                    name = line.split("(")[0].strip()
                    if name:
                        return f"platform=iOS Simulator,name={name}"

            # Fallback to generic iOS Simulator if no iPhone found
            return "generic/platform=iOS Simulator"

        except subprocess.CalledProcessError as e:
            print(f"Warning: Could not auto-detect simulator: {e}", file=sys.stderr)
            return "generic/platform=iOS Simulator"

    def build(self, clean: bool = False) -> tuple[bool, str, str]:
        """
        Build the project.

        Args:
            clean: Perform clean build

        Returns:
            Tuple of (success: bool, xcresult_id: str, stderr: str)
        """
        # Auto-detect scheme if needed
        if not self.scheme:
            self.scheme = self.auto_detect_scheme()
            if not self.scheme:
                print("Error: Could not auto-detect scheme. Use --scheme", file=sys.stderr)
                return (False, "", "")

        # Generate xcresult ID and path
        xcresult_id = self.cache.generate_id()
        xcresult_path = self.cache.get_path(xcresult_id)

        # Build command
        cmd = ["xcodebuild", "-quiet"]  # Suppress verbose output

        if clean:
            cmd.append("clean")

        cmd.append("build")

        if self.workspace_path:
            cmd.extend(["-workspace", self.workspace_path])
        elif self.project_path:
            cmd.extend(["-project", self.project_path])
        else:
            print("Error: No project or workspace specified", file=sys.stderr)
            return (False, "", "")

        cmd.extend(
            [
                "-scheme",
                self.scheme,
                "-configuration",
                self.configuration,
                "-destination",
                self.get_simulator_destination(),
                "-resultBundlePath",
                str(xcresult_path),
            ]
        )

        # Execute build
        try:
            result = subprocess.run(
                cmd,
                capture_output=True,
                text=True,
                check=False,  # Don't raise on non-zero exit
                timeout=BUILD_TIMEOUT,
            )

            success = result.returncode == 0

            # xcresult bundle should be created even on failure
            if not xcresult_path.exists():
                print("Warning: xcresult bundle was not created", file=sys.stderr)
                return (success, "", result.stderr)

            # Auto-update config with last used simulator (on success only)
            if success:
                try:
                    # Determine project directory from project/workspace path
                    project_dir = None
                    if self.project_path:
                        project_dir = Path(self.project_path).parent
                    elif self.workspace_path:
                        project_dir = Path(self.workspace_path).parent

                    config = Config.load(project_dir=project_dir)
                    destination = self.get_simulator_destination()
                    simulator_name = self._extract_simulator_name_from_destination(destination)

                    if simulator_name:
                        config.update_last_used_simulator(simulator_name)
                        config.save()

                except Exception as e:
                    # Don't fail build if config update fails
                    print(f"Warning: Could not update config: {e}", file=sys.stderr)

            return (success, xcresult_id, result.stderr)

        except Exception as e:
            print(f"Error executing build: {e}", file=sys.stderr)
            return (False, "", str(e))

    def test(self, test_suite: str | None = None) -> tuple[bool, str, str]:
        """
        Run tests.

        Args:
            test_suite: Specific test suite to run

        Returns:
            Tuple of (success: bool, xcresult_id: str, stderr: str)
        """
        # Auto-detect scheme if needed
        if not self.scheme:
            self.scheme = self.auto_detect_scheme()
            if not self.scheme:
                print("Error: Could not auto-detect scheme. Use --scheme", file=sys.stderr)
                return (False, "", "")

        # Generate xcresult ID and path
        xcresult_id = self.cache.generate_id()
        xcresult_path = self.cache.get_path(xcresult_id)

        # Build command
        cmd = ["xcodebuild", "-quiet", "test"]

        if self.workspace_path:
            cmd.extend(["-workspace", self.workspace_path])
        elif self.project_path:
            cmd.extend(["-project", self.project_path])
        else:
            print("Error: No project or workspace specified", file=sys.stderr)
            return (False, "", "")

        cmd.extend(
            [
                "-scheme",
                self.scheme,
                "-destination",
                self.get_simulator_destination(),
                "-resultBundlePath",
                str(xcresult_path),
            ]
        )

        if test_suite:
            cmd.extend(["-only-testing", test_suite])

        # Execute tests
        try:
            result = subprocess.run(
                cmd, capture_output=True, text=True, check=False, timeout=TEST_TIMEOUT
            )

            success = result.returncode == 0

            # xcresult bundle should be created even on failure
            if not xcresult_path.exists():
                print("Warning: xcresult bundle was not created", file=sys.stderr)
                return (success, "", result.stderr)

            # Auto-update config with last used simulator (on success only)
            if success:
                try:
                    # Determine project directory from project/workspace path
                    project_dir = None
                    if self.project_path:
                        project_dir = Path(self.project_path).parent
                    elif self.workspace_path:
                        project_dir = Path(self.workspace_path).parent

                    config = Config.load(project_dir=project_dir)
                    destination = self.get_simulator_destination()
                    simulator_name = self._extract_simulator_name_from_destination(destination)

                    if simulator_name:
                        config.update_last_used_simulator(simulator_name)
                        config.save()

                except Exception as e:
                    # Don't fail test if config update fails
                    print(f"Warning: Could not update config: {e}", file=sys.stderr)

            return (success, xcresult_id, result.stderr)

        except Exception as e:
            print(f"Error executing tests: {e}", file=sys.stderr)
            return (False, "", str(e))
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 318kUpdated Claude CodeCodexUnverifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 318kUpdated Claude CodeCodexUnverifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 318kUpdated Claude CodeCodexUnverifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall