ios-rocketsim-operator

iOS RocketSim Operator

Before invoking Apple-only binaries, confirm the execution context is macOS. From Windows or Linux, run those steps in a Mac SSH project or through an already configured remote transport; do not retry missing Apple binaries locally.

Use the installed RocketSim app as the versioned Simulator automation layer. Always resolve the matching app bundle, bundled skill, and CLI before interacting with a simulator.

Discovery

Prefer a running RocketSim bundle:

ROCKETSIM_PID="$(pgrep -x RocketSim | head -1)"
APP_PATH=""
if [ -n "$ROCKETSIM_PID" ]; then
  APP_PATH="$(ps -o command= -p "$ROCKETSIM_PID" | sed 's#/Contents/MacOS/RocketSim$##')"
fi
printf '%s\n' "$APP_PATH"

If not running, enumerate candidates with:

mdfind "kMDItemCFBundleIdentifier == 'com.swiftLee.RocketSim'"

Also check /Applications/RocketSim.app, /Applications/RocketSim 2.app, ~/Applications/RocketSim.app, and ~/Applications/RocketSim 2.app.

For each candidate, validate both files:

test -f "$APP_PATH/Contents/Resources/Agent-Skill/SKILL.md" && \
test -x "$APP_PATH/Contents/Helpers/rocketsim"

Use the first valid candidate. If RocketSim is running, use the running bundle only if it validates; otherwise rediscover or stop.

If no candidate validates, tell the user to launch or install a current RocketSim build from the Mac App Store: https://apps.apple.com/us/app/rocketsim-for-xcode-simulator/id1504940162

Required Paths

After discovery, set:

• Bundled skill: $APP_PATH/Contents/Resources/Agent-Skill/SKILL.md
• CLI: $APP_PATH/Contents/Helpers/rocketsim

Before any CLI call:

pgrep -x RocketSim >/dev/null && echo "Running" || echo "Not running"

If RocketSim is not running, ask the user to launch it. If it is running from a different bundle than APP_PATH, restart discovery and prefer the running bundle.

Handoff

Read the bundled Agent-Skill/SKILL.md and follow it. Wherever it refers to rocketsim, use the resolved absolute CLI path. Do not use ad hoc simulator automation until discovery, validation, and the running-app check pass.