How conorluddy/ios-simulator-skill works
This repository is a Claude Code skill: developers or agents invoke focused Python commands to build/test Xcode projects or control and inspect iOS simulators. The main interaction path is semantic UI navigation and device/app control, with accessibility, visual, log, and app-state analysis as diagnostic branches. Build results are summarized for on-demand detail; HangBuster is a separate hang-monitoring workflow. Shared simulator utilities support the scripts. Relationships among unsampled features are included only where the README documents them; source excerpts are partial.
Main entry points: builder.py Build and test · navigator.py Semantic navigation · hang_watcher.py Hang monitoring · common Simulator utilities
Components 30
Xcode builds
- Build and test
ios-simulator-skill/skills/ios-simulator-skill/scripts/xcode/builder.py - Build configuration
ios-simulator-skill/skills/ios-simulator-skill/scripts/xcode/config.py - Result cache
ios-simulator-skill/skills/ios-simulator-skill/scripts/xcode/cache.py - Result parser
ios-simulator-skill/skills/ios-simulator-skill/scripts/xcode/xcresult.py - Build reporting
ios-simulator-skill/skills/ios-simulator-skill/scripts/xcode/reporter.py
Simulator control
- Simulator lifecycle
ios-simulator-skill/skills/ios-simulator-skill/scripts/simctl_boot.py - Simulator selection
ios-simulator-skill/skills/ios-simulator-skill/scripts/simulator_selector.py - App launcher
ios-simulator-skill/skills/ios-simulator-skill/scripts/app_launcher.py - Device settings
ios-simulator-skill/skills/ios-simulator-skill/scripts/appearance.py - Location simulation
ios-simulator-skill/skills/ios-simulator-skill/scripts/location.py - Privacy settings
ios-simulator-skill/skills/ios-simulator-skill/scripts/privacy_manager.py
UI interaction
- Semantic navigation
ios-simulator-skill/skills/ios-simulator-skill/scripts/navigator.py - Screen mapping
ios-simulator-skill/skills/ios-simulator-skill/scripts/screen_mapper.py - Gestures and keyboard
ios-simulator-skill/skills/ios-simulator-skill/scripts/gesture.py
Testing and analysis
- Accessibility audit
ios-simulator-skill/skills/ios-simulator-skill/scripts/accessibility_audit.py - Localization audit
ios-simulator-skill/skills/ios-simulator-skill/scripts/localization_audit.py - Visual comparison
ios-simulator-skill/skills/ios-simulator-skill/scripts/visual_diff.py - App state capture
ios-simulator-skill/skills/ios-simulator-skill/scripts/app_state_capture.py - Log monitoring
ios-simulator-skill/skills/ios-simulator-skill/scripts/log_monitor.py - Hang monitoring
ios-simulator-skill/skills/ios-simulator-skill/scripts/hang_watcher.py - Hang analysis pipeline
ios-simulator-skill/skills/ios-simulator-skill/scripts/common/hang_pipeline.py - Hang session store
ios-simulator-skill/skills/ios-simulator-skill/scripts/common/hang_sessions.py - App container inspection
ios-simulator-skill/skills/ios-simulator-skill/scripts/container.py - Data model inspection
ios-simulator-skill/skills/ios-simulator-skill/scripts/model_inspector.py
Shared runtime
- Simulator utilities
ios-simulator-skill/skills/ios-simulator-skill/scripts/common - Device helpers
ios-simulator-skill/skills/ios-simulator-skill/scripts/common/device_utils.py
Other components
- Developer or agent
- Xcode toolchain
- simctl
- idb
Connections 32
- Developer or agent → Build and test: runs build or test
README.md - Build and test → Xcode toolchain: invokes xcodebuild
README.md - Build and test → Build configuration: loads preferences
ios-simulator-skill/skills/ios-simulator-skill/scripts/xcode/builder.py - Build and test → Result cache: stores results
ios-simulator-skill/skills/ios-simulator-skill/scripts/xcode/builder.py - Build and test → Result parser: parses results
README.md - Build and test → Build reporting: summarizes results
README.md - Developer or agent → Simulator lifecycle: manages devices
README.md - Simulator lifecycle → simctl: controls simulators
README.md - Developer or agent → Simulator selection: selects simulator
README.md - Developer or agent → App launcher: controls apps
README.md - App launcher → simctl: launches and installs
README.md - Developer or agent → Device settings: changes device state
README.md - Developer or agent → Location simulation: sets simulated location
README.md - Developer or agent → Privacy settings: manages permissions
README.md - Developer or agent → Semantic navigation: finds UI elements
README.md - Semantic navigation → idb: interacts semantically
README.md - Developer or agent → Screen mapping: inspects screen
README.md - Developer or agent → Gestures and keyboard: performs gestures
README.md - Gestures and keyboard → idb: sends interaction
README.md - Semantic navigation → Simulator utilities: imports utilities
ios-simulator-skill/skills/ios-simulator-skill/scripts/navigator.py - Simulator utilities → Device helpers: exports device helpers
ios-simulator-skill/skills/ios-simulator-skill/scripts/common/__init__.py - Developer or agent → Accessibility audit: audits accessibility
README.md - Developer or agent → Localization audit: audits localization
README.md - Developer or agent → Visual comparison: compares screenshots
README.md - Developer or agent → App state capture: captures diagnostics
README.md - Developer or agent → Log monitoring: monitors logs
README.md - Developer or agent → Hang monitoring: monitors hangs
README.md - Hang monitoring → Hang analysis pipeline: filters and ranks
ios-simulator-skill/skills/ios-simulator-skill/scripts/hang_watcher.py - Hang monitoring → Hang session store: stores sessions
ios-simulator-skill/skills/ios-simulator-skill/scripts/hang_watcher.py - Developer or agent → App container inspection: inspects app data
README.md - App container inspection → Simulator utilities: imports utilities
ios-simulator-skill/skills/ios-simulator-skill/scripts/container.py - Developer or agent → Data model inspection: inspects data models
README.md