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/simulator_selector.py

View on GitHub
#!/usr/bin/env python3
"""
Intelligent Simulator Selector

Suggests the best available iOS simulators based on:
- Recently used (from config)
- Latest iOS version
- Common models for testing
- Boot status

Usage Examples:
    # Get suggestions for user selection
    python scripts/simulator_selector.py --suggest

    # List all available simulators
    python scripts/simulator_selector.py --list

    # Boot a specific simulator
    python scripts/simulator_selector.py --boot "67A99DF0-27BD-4507-A3DE-B7D8C38F764A"

    # Get suggestions as JSON for programmatic use
    python scripts/simulator_selector.py --suggest --json
"""

import argparse
import json
import re
import subprocess
import sys
from datetime import datetime
from pathlib import Path
from typing import Optional

# Try to import config from build_and_test if available
try:
    from xcode.config import Config
except ImportError:
    Config = None


class SimulatorInfo:
    """Information about an iOS simulator."""

    def __init__(
        self,
        name: str,
        udid: str,
        ios_version: str,
        status: str,
    ):
        """Initialize simulator info."""
        self.name = name
        self.udid = udid
        self.ios_version = ios_version
        self.status = status
        self.reasons: list[str] = []

    def to_dict(self) -> dict:
        """Convert to dictionary."""
        return {
            "device": self.name,
            "udid": self.udid,
            "ios": self.ios_version,
            "status": self.status,
            "reasons": self.reasons,
        }


class SimulatorSelector:
    """Intelligent simulator selection."""

    # Common iPhone models ranked by testing priority
    COMMON_MODELS = [
        "iPhone 16 Pro",
        "iPhone 16",
        "iPhone 15 Pro",
        "iPhone 15",
        "iPhone SE (3rd generation)",
    ]

    def __init__(self):
        """Initialize selector."""
        self.simulators: list[SimulatorInfo] = []
        self.config: dict | None = None
        self.last_used_simulator: str | None = None

        # Load config if available
        if Config:
            try:
                config = Config.load()
                self.last_used_simulator = config.get_preferred_simulator()
            except Exception:
                pass

    def list_simulators(self) -> list[SimulatorInfo]:
        """
        List all available simulators.

        Returns:
            List of SimulatorInfo objects
        """
        try:
            result = subprocess.run(
                ["xcrun", "simctl", "list", "devices", "--json"],
                capture_output=True,
                text=True,
                check=True,
            )

            data = json.loads(result.stdout)
            simulators = []

            # Parse devices by iOS version
            for runtime, devices in data.get("devices", {}).items():
                # Extract iOS version from runtime (e.g., "com.apple.CoreSimulator.SimRuntime.iOS-18-0")
                ios_version_match = re.search(r"iOS-(\d+-\d+)", runtime)
                if not ios_version_match:
                    continue

                ios_version = ios_version_match.group(1).replace("-", ".")

                for device in devices:
                    name = device.get("name", "")
                    udid = device.get("udid", "")
                    is_available = device.get("isAvailable", False)

                    if not is_available or "iPhone" not in name:
                        continue

                    status = device.get("state", "").capitalize()
                    sim_info = SimulatorInfo(name, udid, ios_version, status)
                    simulators.append(sim_info)

            self.simulators = simulators
            return simulators

        except subprocess.CalledProcessError as e:
            print(f"Error listing simulators: {e.stderr}", file=sys.stderr)
            return []
        except json.JSONDecodeError as e:
            print(f"Error parsing simulator list: {e}", file=sys.stderr)
            return []

    def get_suggestions(self, count: int = 4) -> list[SimulatorInfo]:
        """
        Get top N suggested simulators.

        Ranking factors:
        1. Recently used (from config)
        2. Latest iOS version
        3. Common models
        4. Boot status (Booted preferred)

        Args:
            count: Number of suggestions to return

        Returns:
            List of suggested SimulatorInfo objects
        """
        if not self.simulators:
            return []

        # Score each simulator
        scored = []
        for sim in self.simulators:
            score = self._score_simulator(sim)
            scored.append((score, sim))

        # Sort by score (descending)
        scored.sort(key=lambda x: x[0], reverse=True)

        # Return top N
        suggestions = [sim for _, sim in scored[:count]]

        # Add reasons to each suggestion
        for i, sim in enumerate(suggestions, 1):
            if i == 1:
                sim.reasons.append("Recommended")

            # Check if recently used
            if self.last_used_simulator and self.last_used_simulator == sim.name:
                sim.reasons.append("Recently used")

            # Check if latest iOS
            latest_ios = max(s.ios_version for s in self.simulators)
            if sim.ios_version == latest_ios:
                sim.reasons.append("Latest iOS")

            # Check if common model
            for j, model in enumerate(self.COMMON_MODELS):
                if model in sim.name:
                    sim.reasons.append(f"#{j+1} common model")
                    break

            # Check if booted
            if sim.status == "Booted":
                sim.reasons.append("Currently running")

        return suggestions

    def _score_simulator(self, sim: SimulatorInfo) -> float:
        """
        Score a simulator for ranking.

        Higher score = better recommendation.

        Args:
            sim: Simulator to score

        Returns:
            Score value
        """
        score = 0.0

        # Recently used gets highest priority (100 points)
        if self.last_used_simulator and self.last_used_simulator == sim.name:
            score += 100

        # Latest iOS version (50 points)
        latest_ios = max(s.ios_version for s in self.simulators)
        if sim.ios_version == latest_ios:
            score += 50

        # Common models (30-20 points based on ranking)
        for i, model in enumerate(self.COMMON_MODELS):
            if model in sim.name:
                score += 30 - (i * 2)  # Higher ranking models get more points
                break

        # Currently booted (10 points)
        if sim.status == "Booted":
            score += 10

        # iOS version number (minor factor for breaking ties)
        ios_numeric = float(sim.ios_version.replace(".", ""))
        score += ios_numeric * 0.1

        return score

    def boot_simulator(self, udid: str) -> bool:
        """
        Boot a simulator.

        Args:
            udid: Simulator UDID

        Returns:
            True if successful, False otherwise
        """
        try:
            subprocess.run(
                ["xcrun", "simctl", "boot", udid],
                capture_output=True,
                check=True,
            )
            return True
        except subprocess.CalledProcessError as e:
            print(f"Error booting simulator: {e.stderr}", file=sys.stderr)
            return False


def format_suggestions(suggestions: list[SimulatorInfo], json_format: bool = False) -> str:
    """
    Format suggestions for output.

    Args:
        suggestions: List of suggestions
        json_format: If True, output as JSON

    Returns:
        Formatted string
    """
    if json_format:
        data = {"suggestions": [s.to_dict() for s in suggestions]}
        return json.dumps(data, indent=2)

    if not suggestions:
        return "No simulators available"

    lines = ["Available Simulators:\n"]
    for i, sim in enumerate(suggestions, 1):
        lines.append(f"{i}. {sim.name} (iOS {sim.ios_version})")
        if sim.reasons:
            lines.append(f"   {', '.join(sim.reasons)}")
        lines.append(f"   UDID: {sim.udid}")
        lines.append("")

    return "\n".join(lines)


def main():
    """Main entry point."""
    parser = argparse.ArgumentParser(
        description="Intelligent iOS simulator selector",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""
Examples:
  # Get suggestions for user selection
  python scripts/simulator_selector.py --suggest

  # List all available simulators
  python scripts/simulator_selector.py --list

  # Boot a specific simulator
  python scripts/simulator_selector.py --boot <UDID>

  # Get suggestions as JSON
  python scripts/simulator_selector.py --suggest --json
        """,
    )

    parser.add_argument(
        "--suggest",
        action="store_true",
        help="Get top simulator suggestions",
    )
    parser.add_argument(
        "--list",
        action="store_true",
        help="List all available simulators",
    )
    parser.add_argument(
        "--boot",
        metavar="UDID",
        help="Boot specific simulator by UDID",
    )
    parser.add_argument(
        "--json",
        action="store_true",
        help="Output as JSON",
    )
    parser.add_argument(
        "--count",
        type=int,
        default=4,
        help="Number of suggestions (default: 4)",
    )

    args = parser.parse_args()

    selector = SimulatorSelector()

    if args.boot:
        # Boot specific simulator
        success = selector.boot_simulator(args.boot)
        if success:
            print(f"Booted simulator: {args.boot}")
            return 0
        return 1

    if args.list:
        # List all simulators
        simulators = selector.list_simulators()
        output = format_suggestions(simulators, args.json)
        print(output)
        return 0

    if args.suggest:
        # Get suggestions
        selector.list_simulators()
        suggestions = selector.get_suggestions(args.count)
        output = format_suggestions(suggestions, args.json)
        print(output)
        return 0

    # Default: show suggestions
    selector.list_simulators()
    suggestions = selector.get_suggestions(args.count)
    output = format_suggestions(suggestions, args.json)
    print(output)
    return 0


if __name__ == "__main__":
    sys.exit(main())
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