Skip to content

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

ios-macos-development

Flagged

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

View on GitHub
#!/usr/bin/env python3
"""
App State Capture for iOS Simulator

Captures complete app state including screenshot, accessibility tree, and logs.
Optimized for minimal token output.

Usage: python scripts/app_state_capture.py [options]
"""

import argparse
import json
import subprocess
import sys
from datetime import datetime
from pathlib import Path

from common import (
    capture_screenshot,
    count_elements,
    get_accessibility_tree,
    resolve_udid,
)
from common.env_config import env_int

STATE_SUBPROCESS_TIMEOUT = env_int("IOS_SIM_STATE_SUBPROCESS_TIMEOUT", 15)


class AppStateCapture:
    """Captures comprehensive app state for debugging."""

    def __init__(
        self,
        app_bundle_id: str | None = None,
        udid: str | None = None,
        inline: bool = False,
        screenshot_size: str = "half",
    ):
        """
        Initialize state capture.

        Args:
            app_bundle_id: Optional app bundle ID for log filtering
            udid: Optional device UDID (uses booted if not specified)
            inline: If True, return screenshots as base64 (for vision-based automation)
            screenshot_size: 'full', 'half', 'quarter', 'thumb' (default: 'half')
        """
        self.app_bundle_id = app_bundle_id
        self.udid = udid
        self.inline = inline
        self.screenshot_size = screenshot_size

    def capture_screenshot(self, output_path: Path) -> bool:
        """Capture screenshot of current screen."""
        cmd = ["xcrun", "simctl", "io"]

        if self.udid:
            cmd.append(self.udid)
        else:
            cmd.append("booted")

        cmd.extend(["screenshot", str(output_path)])

        try:
            subprocess.run(cmd, capture_output=True, check=True)
            return True
        except subprocess.CalledProcessError:
            return False

    def capture_accessibility_tree(self, output_path: Path) -> dict:
        """Capture accessibility tree using shared utility."""
        try:
            # Use shared utility to fetch tree
            tree = get_accessibility_tree(self.udid, nested=True)

            # Save tree
            with open(output_path, "w") as f:
                json.dump(tree, f, indent=2)

            # Return summary using shared utility
            return {"captured": True, "element_count": count_elements(tree)}
        except Exception as e:
            return {"captured": False, "error": str(e)}

    def capture_logs(self, output_path: Path, line_limit: int = 100) -> dict:
        """Capture recent app logs."""
        if not self.app_bundle_id:
            # Can't capture logs without app ID
            return {"captured": False, "reason": "No app bundle ID specified"}

        # Get app name from bundle ID (simplified)
        app_name = self.app_bundle_id.split(".")[-1]

        cmd = ["xcrun", "simctl", "spawn"]

        if self.udid:
            cmd.append(self.udid)
        else:
            cmd.append("booted")

        cmd.extend(
            [
                "log",
                "show",
                "--predicate",
                f'process == "{app_name}"',
                "--last",
                "1m",  # Last 1 minute
                "--style",
                "compact",
            ]
        )

        try:
            result = subprocess.run(
                cmd,
                check=False,
                capture_output=True,
                text=True,
                timeout=STATE_SUBPROCESS_TIMEOUT,
            )
            logs = result.stdout

            # Limit lines for token efficiency
            lines = logs.split("\n")
            if len(lines) > line_limit:
                lines = lines[-line_limit:]

            # Save logs
            with open(output_path, "w") as f:
                f.write("\n".join(lines))

            # Analyze for issues
            warning_count = sum(1 for line in lines if "warning" in line.lower())
            error_count = sum(1 for line in lines if "error" in line.lower())

            return {
                "captured": True,
                "lines": len(lines),
                "warnings": warning_count,
                "errors": error_count,
            }
        except (subprocess.CalledProcessError, subprocess.TimeoutExpired) as e:
            return {"captured": False, "error": str(e)}

    def capture_device_info(self) -> dict:
        """Get device information."""
        cmd = ["xcrun", "simctl", "list", "devices", "booted"]

        if self.udid:
            # Specific device info
            cmd = ["xcrun", "simctl", "list", "devices"]

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

            # Parse output for device info (simplified)
            lines = result.stdout.split("\n")
            device_info = {}

            for line in lines:
                if "iPhone" in line or "iPad" in line:
                    # Extract device name and state
                    parts = line.strip().split("(")
                    if parts:
                        device_info["name"] = parts[0].strip()
                        if len(parts) > 2:
                            device_info["udid"] = parts[1].replace(")", "").strip()
                            device_info["state"] = parts[2].replace(")", "").strip()
                    break

            return device_info
        except subprocess.CalledProcessError:
            return {}

    def capture_all(
        self, output_dir: str, log_lines: int = 100, app_name: str | None = None
    ) -> dict:
        """
        Capture complete app state.

        Args:
            output_dir: Directory to save artifacts
            log_lines: Number of log lines to capture
            app_name: App name for semantic naming (for inline mode)

        Returns:
            Summary of captured state
        """
        # Create output directory (only if not in inline mode)
        output_path = Path(output_dir)
        timestamp = datetime.now().strftime("%Y%m%d-%H%M%S")
        if not self.inline:
            capture_dir = output_path / f"app-state-{timestamp}"
            capture_dir.mkdir(parents=True, exist_ok=True)
        else:
            capture_dir = None

        summary = {
            "timestamp": datetime.now().isoformat(),
            "screenshot_mode": "inline" if self.inline else "file",
        }

        if capture_dir:
            summary["output_dir"] = str(capture_dir)

        # Capture screenshot using new unified utility
        screenshot_result = capture_screenshot(
            self.udid,
            size=self.screenshot_size,
            inline=self.inline,
            app_name=app_name,
        )

        if self.inline:
            # Inline mode: store base64
            summary["screenshot"] = {
                "mode": "inline",
                "base64": screenshot_result["base64_data"],
                "width": screenshot_result["width"],
                "height": screenshot_result["height"],
                "size_preset": self.screenshot_size,
            }
        else:
            # File mode: save to disk
            screenshot_path = capture_dir / "screenshot.png"
            # Move temp file to target location
            import shutil

            shutil.move(screenshot_result["file_path"], screenshot_path)
            summary["screenshot"] = {
                "mode": "file",
                "file": "screenshot.png",
                "size_bytes": screenshot_result["size_bytes"],
            }

        # Capture accessibility tree
        if not self.inline or capture_dir:
            accessibility_path = (capture_dir or output_path) / "accessibility-tree.json"
        else:
            accessibility_path = None

        if accessibility_path:
            tree_info = self.capture_accessibility_tree(accessibility_path)
            summary["accessibility"] = tree_info

        # Capture logs (if app ID provided)
        if self.app_bundle_id:
            if not self.inline or capture_dir:
                logs_path = (capture_dir or output_path) / "app-logs.txt"
            else:
                logs_path = None

            if logs_path:
                log_info = self.capture_logs(logs_path, log_lines)
                summary["logs"] = log_info

        # Get device info
        device_info = self.capture_device_info()
        if device_info:
            summary["device"] = device_info
            # Save device info (file mode only)
            if capture_dir:
                with open(capture_dir / "device-info.json", "w") as f:
                    json.dump(device_info, f, indent=2)

        # Save summary (file mode only)
        if capture_dir:
            with open(capture_dir / "summary.json", "w") as f:
                json.dump(summary, f, indent=2)

            # Create markdown summary
            self._create_summary_md(capture_dir, summary)

        return summary

    def _create_summary_md(self, capture_dir: Path, summary: dict) -> None:
        """Create markdown summary file."""
        md_path = capture_dir / "summary.md"

        with open(md_path, "w") as f:
            f.write("# App State Capture\n\n")
            f.write(f"**Timestamp:** {summary['timestamp']}\n\n")

            if "device" in summary:
                f.write("## Device\n")
                device = summary["device"]
                f.write(f"- Name: {device.get('name', 'Unknown')}\n")
                f.write(f"- UDID: {device.get('udid', 'N/A')}\n")
                f.write(f"- State: {device.get('state', 'Unknown')}\n\n")

            f.write("## Screenshot\n")
            f.write("![Current Screen](screenshot.png)\n\n")

            if "accessibility" in summary:
                acc = summary["accessibility"]
                f.write("## Accessibility\n")
                if acc.get("captured"):
                    f.write(f"- Elements: {acc.get('element_count', 0)}\n")
                else:
                    f.write(f"- Error: {acc.get('error', 'Unknown')}\n")
                f.write("\n")

            if "logs" in summary:
                logs = summary["logs"]
                f.write("## Logs\n")
                if logs.get("captured"):
                    f.write(f"- Lines: {logs.get('lines', 0)}\n")
                    f.write(f"- Warnings: {logs.get('warnings', 0)}\n")
                    f.write(f"- Errors: {logs.get('errors', 0)}\n")
                else:
                    f.write(f"- {logs.get('reason', logs.get('error', 'Not captured'))}\n")
                f.write("\n")

            f.write("## Files\n")
            f.write("- `screenshot.png` - Current screen\n")
            f.write("- `accessibility-tree.json` - Full UI hierarchy\n")
            if self.app_bundle_id:
                f.write("- `app-logs.txt` - Recent app logs\n")
            f.write("- `device-info.json` - Device details\n")
            f.write("- `summary.json` - Complete capture metadata\n")


def main():
    """Main entry point."""
    parser = argparse.ArgumentParser(description="Capture complete app state for debugging")
    parser.add_argument(
        "--app-bundle-id", help="App bundle ID for log filtering (e.g., com.example.app)"
    )
    parser.add_argument(
        "--output", default=".", help="Output directory (default: current directory)"
    )
    parser.add_argument(
        "--log-lines", type=int, default=100, help="Number of log lines to capture (default: 100)"
    )
    parser.add_argument(
        "--udid",
        help="Device UDID (auto-detects booted simulator if not provided)",
    )
    parser.add_argument(
        "--inline",
        action="store_true",
        help="Return screenshots as base64 (inline mode for vision-based automation)",
    )
    parser.add_argument(
        "--size",
        choices=["full", "half", "quarter", "thumb"],
        default="half",
        help="Screenshot size for token optimization (default: half)",
    )
    parser.add_argument("--app-name", help="App name for semantic screenshot naming")

    args = parser.parse_args()

    # Resolve UDID with auto-detection
    try:
        udid = resolve_udid(args.udid)
    except RuntimeError as e:
        print(f"Error: {e}")
        sys.exit(1)

    # Create capturer
    capturer = AppStateCapture(
        app_bundle_id=args.app_bundle_id,
        udid=udid,
        inline=args.inline,
        screenshot_size=args.size,
    )

    # Capture state
    try:
        summary = capturer.capture_all(
            output_dir=args.output, log_lines=args.log_lines, app_name=args.app_name
        )

        # Token-efficient output
        if "output_dir" in summary:
            print(f"State captured: {summary['output_dir']}/")
        else:
            # Inline mode
            print(
                f"State captured (inline mode): {summary['screenshot']['width']}x{summary['screenshot']['height']}"
            )

        # Report any issues found
        if "logs" in summary and summary["logs"].get("captured"):
            logs = summary["logs"]
            if logs["errors"] > 0 or logs["warnings"] > 0:
                print(f"Issues found: {logs['errors']} errors, {logs['warnings']} warnings")

        if "accessibility" in summary and summary["accessibility"].get("captured"):
            print(f"Elements: {summary['accessibility']['element_count']}")

    except Exception as e:
        print(f"Error: {e}")
        sys.exit(1)


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: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
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