simbridge

A CLI for iOS simulator interactions. Wraps idb_companion and xcrun simctl to expose UI automation, screen recording, and simulator status in a single tool.

Requirements

• idb_companion in PATH (brew install idb-companion)
• Xcode with xcrun simctl

Usage

# List running simulators
simbridge status

# Inspect the UI of the frontmost app
simbridge ui describe-screen

# Tap an element by label or index
simbridge ui tap "Log In"
simbridge ui tap 3

# Type text into a focused element
simbridge ui type --target "Email" --text "user@example.com"

# Take a screenshot or record a video
simbridge screenshot out.png
simbridge record          # Ctrl-C to stop; saves recording_<timestamp>.mp4

If multiple simulators are running, pass --udid <UDID> or set SIMBRIDGE_UDID to target a specific one.