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

View on GitHub
#!/usr/bin/env python3
"""
iOS Simulator Listing with Progressive Disclosure

Lists available simulators with token-efficient summaries.
Full details available on demand via cache IDs.

Achieves 96% token reduction (57k→2k tokens) for common queries.

Usage Examples:
    # Concise summary (default)
    python scripts/sim_list.py

    # Get full details for cached list
    python scripts/sim_list.py --get-details <cache-id>

    # Get recommendations
    python scripts/sim_list.py --suggest

    # Filter by device type
    python scripts/sim_list.py --device-type iPhone

Output (default):
    Simulator Summary [cache-sim-20251028-143052]
    ├─ Total: 47 devices
    ├─ Available: 31
    └─ Booted: 1

    ✓ iPhone 16 Pro (iOS 18.1) [ABC-123...]

    Use --get-details cache-sim-20251028-143052 for full list

Technical Details:
- Uses xcrun simctl list devices
- Caches results with 1-hour TTL
- Reduces output by 96% by default
- Token efficiency: summary = ~30 tokens, full list = ~1500 tokens
"""

import argparse
import json
import subprocess
import sys
from typing import Any

from common import get_cache


class SimulatorLister:
    """Lists iOS simulators with progressive disclosure."""

    def __init__(self):
        """Initialize lister with cache."""
        self.cache = get_cache()

    def list_simulators(self) -> dict:
        """
        Get list of all simulators.

        Returns:
            Dict with structure:
            {
                "devices": [...],
                "runtimes": [...],
                "total_devices": int,
                "available_devices": int,
                "booted_devices": [...]
            }
        """
        try:
            result = subprocess.run(
                ["xcrun", "simctl", "list", "devices", "--json"],
                capture_output=True,
                text=True,
                check=True,
            )

            return json.loads(result.stdout)
        except (subprocess.CalledProcessError, json.JSONDecodeError):
            return {"devices": {}, "runtimes": []}

    def parse_devices(self, sim_data: dict) -> list[dict]:
        """
        Parse simulator data into flat list.

        Returns:
            List of device dicts with runtime info
        """
        devices = []

        devices_by_runtime = sim_data.get("devices", {})

        for runtime_str, device_list in devices_by_runtime.items():
            # Extract iOS version from runtime string
            # Format: "iOS 18.1", "tvOS 18", etc.
            runtime_name = runtime_str.replace(" Simulator", "").strip()

            for device in device_list:
                devices.append(
                    {
                        "name": device.get("name"),
                        "udid": device.get("udid"),
                        "state": device.get("state"),
                        "runtime": runtime_name,
                        "is_available": device.get("isAvailable", False),
                    }
                )

        return devices

    def get_concise_summary(self, devices: list[dict]) -> dict:
        """
        Generate concise summary with cache ID.

        Returns 96% fewer tokens than full list.
        """
        booted = [d for d in devices if d["state"] == "Booted"]
        available = [d for d in devices if d["is_available"]]
        iphone = [d for d in available if "iPhone" in d["name"]]

        # Cache full list for later retrieval
        cache_id = self.cache.save(
            {
                "devices": devices,
                "timestamp": __import__("datetime").datetime.now().isoformat(),
            },
            "simulator-list",
        )

        return {
            "cache_id": cache_id,
            "summary": {
                "total_devices": len(devices),
                "available_devices": len(available),
                "booted_devices": len(booted),
            },
            "quick_access": {
                "booted": booted[:3] if booted else [],
                "recommended_iphone": iphone[:3] if iphone else [],
            },
        }

    def get_full_list(
        self,
        cache_id: str,
        device_type: str | None = None,
        runtime: str | None = None,
    ) -> list[dict] | None:
        """
        Retrieve full simulator list from cache.

        Args:
            cache_id: Cache ID from concise summary
            device_type: Filter by type (iPhone, iPad, etc.)
            runtime: Filter by iOS version

        Returns:
            List of devices matching filters
        """
        data = self.cache.get(cache_id)
        if not data:
            return None

        devices = data.get("devices", [])

        # Apply filters
        if device_type:
            devices = [d for d in devices if device_type in d["name"]]
        if runtime:
            devices = [d for d in devices if runtime.lower() in d["runtime"].lower()]

        return devices

    def suggest_simulators(self, limit: int = 4) -> list[dict]:
        """
        Get simulator recommendations.

        Returns:
            List of recommended simulators (best candidates for building)
        """
        all_sims = self.list_simulators()
        devices = self.parse_devices(all_sims)

        # Score devices for recommendations
        scored = []
        for device in devices:
            score = 0

            # Prefer booted
            if device["state"] == "Booted":
                score += 10
            # Prefer available
            if device["is_available"]:
                score += 5
            # Prefer recent iOS versions
            ios_version = device["runtime"]
            if "18" in ios_version:
                score += 3
            elif "17" in ios_version:
                score += 2
            # Prefer iPhones over other types
            if "iPhone" in device["name"]:
                score += 1

            scored.append({"device": device, "score": score})

        # Sort by score and return top N
        scored.sort(key=lambda x: x["score"], reverse=True)
        return [s["device"] for s in scored[:limit]]


def format_device(device: dict) -> str:
    """Format device for display."""
    state_icon = "✓" if device["state"] == "Booted" else " "
    avail_icon = "●" if device["is_available"] else "○"
    name = device["name"]
    runtime = device["runtime"]
    udid_short = device["udid"][:8] + "..."
    return f"{state_icon} {avail_icon} {name} ({runtime}) [{udid_short}]"


def main():
    """Main entry point."""
    parser = argparse.ArgumentParser(description="List iOS simulators with progressive disclosure")
    parser.add_argument(
        "--get-details",
        metavar="CACHE_ID",
        help="Get full details for cached simulator list",
    )
    parser.add_argument("--suggest", action="store_true", help="Get simulator recommendations")
    parser.add_argument(
        "--device-type",
        help="Filter by device type (iPhone, iPad, Apple Watch, etc.)",
    )
    parser.add_argument("--runtime", help="Filter by iOS version (e.g., iOS-18, iOS-17)")
    parser.add_argument("--json", action="store_true", help="Output as JSON")

    args = parser.parse_args()

    lister = SimulatorLister()

    # Get full list with details
    if args.get_details:
        devices = lister.get_full_list(
            args.get_details, device_type=args.device_type, runtime=args.runtime
        )

        if devices is None:
            print(f"Error: Cache ID not found or expired: {args.get_details}")
            sys.exit(1)

        if args.json:
            print(json.dumps(devices, indent=2))
        else:
            print(f"Simulators ({len(devices)}):\n")
            for device in devices:
                print(f"  {format_device(device)}")

    # Get recommendations
    elif args.suggest:
        suggestions = lister.suggest_simulators()

        if args.json:
            print(json.dumps(suggestions, indent=2))
        else:
            print("Recommended Simulators:\n")
            for i, device in enumerate(suggestions, 1):
                print(f"{i}. {format_device(device)}")

    # Default: concise summary
    else:
        all_sims = lister.list_simulators()
        devices = lister.parse_devices(all_sims)
        summary = lister.get_concise_summary(devices)

        if args.json:
            print(json.dumps(summary, indent=2))
        else:
            # Human-readable concise output
            cache_id = summary["cache_id"]
            s = summary["summary"]
            q = summary["quick_access"]

            print(f"Simulator Summary [{cache_id}]")
            print(f"├─ Total: {s['total_devices']} devices")
            print(f"├─ Available: {s['available_devices']}")
            print(f"└─ Booted: {s['booted_devices']}")

            if q["booted"]:
                print()
                for device in q["booted"]:
                    print(f"  {format_device(device)}")

            print()
            print(f"Use --get-details {cache_id} for full list")


if __name__ == "__main__":
    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