Claude-skill-registry ios-simulator

Build and run iOS app on simulator. Use when user asks to run on simulator, test on simulator, or debug iOS app locally. Handles building, deploying, and log streaming.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/ios-simulator" ~/.claude/skills/majiayu000-claude-skill-registry-ios-simulator && rm -rf "$T"

manifest: skills/data/ios-simulator/SKILL.md

iOS Simulator Deployment & Debugging

This is an action skill. Run commands, don't just explain them.

Quick Commands

Build and run on simulator:

cd apps/ios && ./scripts/run.sh

This script:

Builds the app (always rebuilds to pick up code changes)
Boots iPhone 17 Pro simulator
Installs and launches the app

Debugging / Log Streaming

Important:

print()

does NOT show in Console.app. Use

NSLog()

os_log

instead.

Stream app logs in terminal:

xcrun simctl spawn booted log stream --predicate 'eventMessage CONTAINS "[YourTag]"' --level debug

Stream all app logs:

xcrun simctl spawn booted log stream --predicate 'subsystem == "com.bytespell.shella"' --level debug

Check if app is running:

xcrun simctl spawn booted launchctl list | grep shella

Clean Build

If you suspect stale code is being used:

cd apps/ios && rm -rf .build && ./scripts/run.sh

Troubleshooting

App doesn't reflect code changes:

The
```
run.sh
```
script now always rebuilds, but if issues persist, do a clean build (see above)

Logs not appearing:

```
print()
```
statements don't show in Console.app - use
```
NSLog("message")
```
or
```
os_log
```
Make sure Console.app is filtering by "Simulator" in the sidebar
Enable "Include Info Messages" and "Include Debug Messages" in Console.app's Action menu

Simulator won't boot:

xcrun simctl shutdown all
xcrun simctl boot "iPhone 17 Pro"

Kill and restart app:

xcrun simctl terminate booted com.bytespell.shella
xcrun simctl launch booted com.bytespell.shella

Typical Flow

User: "run on simulator" / "test this on iOS" / "build and run"

Run the build+deploy script:

cd apps/ios && ./scripts/run.sh

If user needs logs, start streaming:

xcrun simctl spawn booted log stream --predicate 'eventMessage CONTAINS "[SomeTag]"' --level debug

For debugging, remind user that
```
print()
```
won't show - they need
```
NSLog()
```
.