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

View on GitHub
#!/usr/bin/env python3
"""
GPS location simulation for iOS simulators.

Set a fixed coordinate, use a named city preset, play back a GPX route,
walk a multi-waypoint path, or clear any active location override.

Wraps `xcrun simctl location <udid> set/clear/start/run`.

Key features:
- Set precise lat/lng coordinates
- 15 built-in city presets
- GPX scenario playback (built-in scenarios only — simctl limitation)
- Multi-waypoint path with configurable speed and update interval
- Clear active location override
- Standard --json, --verbose, and --udid flags

Usage examples:
    python scripts/location.py --lat 53.3498 --lng -6.2603
    python scripts/location.py --city Dublin
    python scripts/location.py --gpx FreewayDrive
    python scripts/location.py --waypoints "37.33,-122.03 37.78,-122.41" --speed 10
    python scripts/location.py --clear
"""

import argparse
import json
import subprocess
import sys

from common import resolve_udid

# === PRESETS ===

_CITY_ALIASES: set[str] = {"nyc", "sf", "la"}

CITY_PRESETS: dict[str, tuple[float, float]] = {
    "dublin": (53.3498, -6.2603),
    "london": (51.5074, -0.1278),
    "newyork": (40.7128, -74.0060),
    "nyc": (40.7128, -74.0060),
    "sanfrancisco": (37.7749, -122.4194),
    "sf": (37.7749, -122.4194),
    "tokyo": (35.6762, 139.6503),
    "sydney": (-33.8688, 151.2093),
    "paris": (48.8566, 2.3522),
    "berlin": (52.5200, 13.4050),
    "beijing": (39.9042, 116.4074),
    "mumbai": (19.0760, 72.8777),
    "cairo": (30.0444, 31.2357),
    "saopaulo": (-23.5505, -46.6333),
    "losangeles": (34.0522, -118.2437),
    "la": (34.0522, -118.2437),
}


# === MAIN CLASS ===


class LocationManager:
    """Manage simulated GPS location on an iOS simulator."""

    def __init__(self, udid: str | None = None):
        """Initialize with optional device UDID.

        Args:
            udid: Simulator UDID — auto-detects booted device if None.
        """
        self.udid = udid

    def set_coordinate(self, lat: float, lng: float, verbose: bool = False) -> tuple[bool, str]:
        """
        Set simulator GPS to a fixed coordinate.

        Args:
            lat: Latitude in decimal degrees (-90 to 90).
            lng: Longitude in decimal degrees (-180 to 180).
            verbose: Include extra context in the returned message.

        Returns:
            (success, message) tuple.
        """
        if not (-90 <= lat <= 90):
            return False, f"Invalid latitude {lat}: must be between -90 and 90"
        if not (-180 <= lng <= 180):
            return False, f"Invalid longitude {lng}: must be between -180 and 180"

        coord = f"{lat},{lng}"
        cmd = ["xcrun", "simctl", "location", self.udid, "set", coord]

        try:
            result = subprocess.run(cmd, check=False, capture_output=True, text=True, timeout=15)
        except subprocess.TimeoutExpired:
            return False, "Error: location set timed out"
        except Exception as e:
            return False, f"Error: {e}"

        if result.returncode != 0:
            error = result.stderr.strip() or "unknown error"
            return False, f"location set failed: {error}"

        if verbose:
            return True, (
                f"Location set\n"
                f"  Latitude:  {lat}\n"
                f"  Longitude: {lng}\n"
                f"  Device:    {self.udid}"
            )
        return True, f"Location set: {lat}, {lng}"

    def set_city(self, city_name: str, verbose: bool = False) -> tuple[bool, str]:
        """
        Set location to a named city preset.

        Args:
            city_name: Case-insensitive city name from CITY_PRESETS.
            verbose: Include coordinate detail in the returned message.

        Returns:
            (success, message) tuple.
        """
        key = city_name.lower().replace(" ", "")
        if key not in CITY_PRESETS:
            available = ", ".join(sorted({k for k in CITY_PRESETS if k not in _CITY_ALIASES}))
            return False, f"Unknown city '{city_name}'. Available: {available}"

        lat, lng = CITY_PRESETS[key]
        success, message = self.set_coordinate(lat, lng, verbose=verbose)

        if success and not verbose:
            return True, f"Location set: {city_name.title()} ({lat}, {lng})"
        return success, message

    def run_gpx_scenario(self, scenario: str, verbose: bool = False) -> tuple[bool, str]:
        """
        Run a named GPX location scenario built into the simulator.

        Use `xcrun simctl location <udid> list` to see available scenarios.

        Args:
            scenario: Scenario name (e.g. "FreewayDrive", "ApplePark").
            verbose: Include extra context in the returned message.

        Returns:
            (success, message) tuple.
        """
        cmd = ["xcrun", "simctl", "location", self.udid, "run", scenario]

        try:
            result = subprocess.run(cmd, check=False, capture_output=True, text=True, timeout=15)
        except subprocess.TimeoutExpired:
            return False, "Error: location run timed out"
        except Exception as e:
            return False, f"Error: {e}"

        if result.returncode != 0:
            error = result.stderr.strip() or "unknown error"
            return False, f"GPX scenario failed: {error}"

        if verbose:
            return True, f"GPX scenario running\n  Scenario: {scenario}\n  Device:   {self.udid}"
        return True, f"GPX scenario running: {scenario}"

    def list_scenarios(self) -> tuple[bool, list[str], str]:
        """
        List built-in location scenarios available on this simulator.

        Returns:
            (success, scenarios, error) tuple where scenarios is a list of names
            and error is an empty string on success or a description of the failure.
        """
        cmd = ["xcrun", "simctl", "location", self.udid, "list"]

        try:
            result = subprocess.run(cmd, check=False, capture_output=True, text=True, timeout=15)
        except subprocess.TimeoutExpired:
            return False, [], "Error: list scenarios timed out"
        except Exception as e:
            return False, [], f"Error: {e}"

        if result.returncode != 0:
            error = result.stderr.strip() or "unknown error"
            return False, [], f"list scenarios failed: {error}"

        lines = [ln.strip() for ln in result.stdout.splitlines() if ln.strip()]
        return True, lines, ""

    def start_waypoints(
        self,
        waypoints: list[tuple[float, float]],
        speed_mps: float = 20.0,
        interval_seconds: float | None = None,
        distance_meters: float | None = None,
        verbose: bool = False,
    ) -> tuple[bool, str]:
        """
        Animate the location along a series of waypoints.

        Requires at least two waypoints.

        Args:
            waypoints: List of (lat, lng) pairs.
            speed_mps: Movement speed in metres per second (default 20 m/s).
            interval_seconds: Location update interval in seconds; mutually exclusive with distance_meters.
            distance_meters: Location update distance in metres; mutually exclusive with interval_seconds.
            verbose: Include waypoint list in the returned message.

        Returns:
            (success, message) tuple.
        """
        if len(waypoints) < 2:
            return False, "At least two waypoints are required for --waypoints"

        coord_args = [f"{lat},{lng}" for lat, lng in waypoints]
        cmd = [
            "xcrun",
            "simctl",
            "location",
            self.udid,
            "start",
            f"--speed={speed_mps}",
        ]
        if interval_seconds is not None:
            cmd.append(f"--interval={interval_seconds}")
        if distance_meters is not None:
            cmd.append(f"--distance={distance_meters}")
        cmd.extend(coord_args)

        try:
            result = subprocess.run(cmd, check=False, capture_output=True, text=True, timeout=15)
        except subprocess.TimeoutExpired:
            return False, "Error: location start timed out"
        except Exception as e:
            return False, f"Error: {e}"

        if result.returncode != 0:
            error = result.stderr.strip() or "unknown error"
            return False, f"Waypoint route failed: {error}"

        if verbose:
            pts = "\n".join(f"  {i + 1}. {lat}, {lng}" for i, (lat, lng) in enumerate(waypoints))
            return True, (
                f"Waypoint route started\n"
                f"  Speed:     {speed_mps} m/s\n"
                f"  Waypoints:\n{pts}\n"
                f"  Device:    {self.udid}"
            )
        return True, f"Waypoint route started: {len(waypoints)} points at {speed_mps} m/s"

    def clear(self, verbose: bool = False) -> tuple[bool, str]:
        """
        Clear any active location simulation and restore real GPS.

        Args:
            verbose: Include extra context in the returned message.

        Returns:
            (success, message) tuple.
        """
        cmd = ["xcrun", "simctl", "location", self.udid, "clear"]

        try:
            result = subprocess.run(cmd, check=False, capture_output=True, text=True, timeout=15)
        except subprocess.TimeoutExpired:
            return False, "Error: location clear timed out"
        except Exception as e:
            return False, f"Error: {e}"

        if result.returncode != 0:
            error = result.stderr.strip() or "unknown error"
            return False, f"location clear failed: {error}"

        if verbose:
            return True, f"Location cleared\n  Device: {self.udid}"
        return True, "Location cleared"


# === CLI ===


def _parse_waypoints(raw: str) -> list[tuple[float, float]]:
    """
    Parse a whitespace-separated string of 'lat,lng' pairs.

    Args:
        raw: e.g. "53.34,-6.26 51.50,-0.12"

    Returns:
        List of (lat, lng) float tuples.

    Raises:
        ValueError: If any pair is malformed.
    """
    pairs = []
    for token in raw.split():
        parts = token.split(",")
        if len(parts) != 2:
            raise ValueError(f"Expected 'lat,lng', got: {token!r}")
        try:
            pairs.append((float(parts[0]), float(parts[1])))
        except ValueError:
            raise ValueError(f"Non-numeric coordinate in: {token!r}") from None
    return pairs


def main() -> None:
    """CLI entry point."""
    parser = argparse.ArgumentParser(
        description="Simulate GPS location on an iOS simulator",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""
Examples:
  python scripts/location.py --lat 53.3498 --lng -6.2603
  python scripts/location.py --city Dublin
  python scripts/location.py --gpx FreewayDrive
  python scripts/location.py --waypoints "37.33,-122.03 37.78,-122.41" --speed 10
  python scripts/location.py --clear
  python scripts/location.py --list-scenarios
""",
    )

    # Device selection
    parser.add_argument("--udid", help="Target device UDID (auto-detects booted simulator)")

    # Location actions (mutually exclusive)
    action_group = parser.add_mutually_exclusive_group(required=True)
    action_group.add_argument("--lat", type=float, help="Latitude (requires --lng)")
    action_group.add_argument("--city", metavar="NAME", help="Named city preset")
    action_group.add_argument("--gpx", metavar="SCENARIO", help="Run a built-in GPX scenario name")
    action_group.add_argument(
        "--waypoints",
        metavar="'lat,lng ...'",
        help="Whitespace-separated lat,lng pairs for animated route",
    )
    action_group.add_argument("--clear", action="store_true", help="Clear location override")
    action_group.add_argument(
        "--list-scenarios", action="store_true", help="List available built-in GPX scenarios"
    )

    # Coordinate companion
    parser.add_argument("--lng", type=float, help="Longitude (used with --lat)")

    # Waypoint options
    parser.add_argument(
        "--speed",
        type=float,
        default=20.0,
        metavar="M_PER_SEC",
        help="Movement speed in m/s for --waypoints (default: 20)",
    )

    waypoint_pace = parser.add_mutually_exclusive_group()
    waypoint_pace.add_argument(
        "--interval",
        type=float,
        metavar="SECONDS",
        help="Location update interval in seconds for --waypoints (mutually exclusive with --distance)",
    )
    waypoint_pace.add_argument(
        "--distance",
        type=float,
        metavar="METERS",
        help="Location update distance in metres for --waypoints (mutually exclusive with --interval)",
    )

    # Output flags
    parser.add_argument("--json", action="store_true", help="Output as JSON")
    parser.add_argument("--verbose", action="store_true", help="Verbose output")

    args = parser.parse_args()

    # Validate --lat and --lng must be provided together
    if (args.lat is None) != (args.lng is None):
        parser.error("--lat and --lng must be provided together")

    # Resolve device UDID
    try:
        udid = resolve_udid(args.udid)
    except RuntimeError as e:
        print(f"Error: {e}", file=sys.stderr)
        sys.exit(1)

    manager = LocationManager(udid=udid)

    # === Dispatch ===

    if args.lat is not None:
        success, message = manager.set_coordinate(args.lat, args.lng, verbose=args.verbose)
        action = "set_coordinate"
        extra: dict = {"lat": args.lat, "lng": args.lng}

    elif args.city:
        success, message = manager.set_city(args.city, verbose=args.verbose)
        action = "set_city"
        key = args.city.lower().replace(" ", "")
        extra = {
            "city": args.city,
            "lat": CITY_PRESETS[key][0] if key in CITY_PRESETS else None,
            "lng": CITY_PRESETS[key][1] if key in CITY_PRESETS else None,
        }

    elif args.gpx:
        success, message = manager.run_gpx_scenario(args.gpx, verbose=args.verbose)
        action = "run_gpx"
        extra = {"scenario": args.gpx}

    elif args.waypoints:
        try:
            waypoints = _parse_waypoints(args.waypoints)
        except ValueError as e:
            print(f"Error: {e}", file=sys.stderr)
            sys.exit(1)
        success, message = manager.start_waypoints(
            waypoints,
            speed_mps=args.speed,
            interval_seconds=args.interval,
            distance_meters=args.distance,
            verbose=args.verbose,
        )
        action = "start_waypoints"
        extra = {
            "waypoints": [{"lat": lat, "lng": lng} for lat, lng in waypoints],
            "speed_mps": args.speed,
        }

    elif args.list_scenarios:
        ok, scenarios, list_error = manager.list_scenarios()
        if args.json:
            payload: dict = {"action": "list_scenarios", "udid": udid, "scenarios": scenarios}
            if not ok:
                payload["error"] = list_error
            print(json.dumps(payload))
        elif ok and scenarios:
            print("\n".join(f"  {s}" for s in scenarios))
        elif ok:
            print("No scenarios available")
        else:
            print(list_error, file=sys.stderr)
        sys.exit(0 if ok else 1)

    else:  # --clear
        success, message = manager.clear(verbose=args.verbose)
        action = "clear"
        extra = {}

    # === Output ===

    if args.json:
        print(
            json.dumps(
                {
                    "action": action,
                    "udid": udid,
                    "success": success,
                    "message": message,
                    **extra,
                }
            )
        )
    else:
        print(message)

    sys.exit(0 if success else 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: 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