sentry-cocoa-sdk

A full Sentry SDK setup wizard for Apple platforms — iOS, macOS, tvOS, watchOS, and visionOS — covering both SwiftUI and UIKit. It applies when adding Sentry to an iOS or Swift app, installing sentry-cocoa, or configuring error monitoring, tracing, profiling, session replay, logging, or metrics. The doc reflects sentry-cocoa 9.15.0 at time of writing and repeatedly advises verifying against the official Apple platform docs before implementing, since SDK versions and APIs change.

The skill runs as an opinionated three-plus-phase workflow. Phase 1 (Detect) runs grep and ls commands to find an existing Sentry dependency, determine the UI framework (SwiftUI @main App struct versus UIKit AppDelegate), detect platforms and deployment targets, spot an existing logging library, and check for a companion backend. Phase 2 (Recommend) leads with a concrete proposal rather than open questions: Error Monitoring and Tracing always, Profiling for production iOS/macOS apps, with Session Replay, Logging, Metrics, and User Feedback as optional enhancements. A recommendation-logic table notes platform constraints, and it flags that Crons and AI Monitoring are not available for Cocoa.

Phase 3 (Guide) covers installation through four options: the Sentry Wizard (recommended, but the user must run it themselves because it opens a browser and needs interactive input), Swift Package Manager, CocoaPods (deprecated, with publishing planned to stop at end of June 2026), and SentryObjC for pure Objective-C/C++ projects that cannot enable Clang modules. It details SPM product selection — choose exactly one of Sentry, Sentry-Dynamic, SentrySwiftUI, Sentry-WithoutUIKitOrAppKit, or SentrySPM with the NoUIFramework trait — and documents Swift 6.1+ trait-based opt-out of UIKit/AppKit, Xcode 26.4+ trait visibility, and known issues such as the Xcode 14+ rsync.samba sandbox error fixed by disabling User Script Sandbox. Model invocation is disabled, and the skill sits under the Sentry SDK Setup tree.