Skip to content
TakoAPI
Back to skills

ios-simulator

by tristanmanchester

iOS & macOS Development
3.0kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Automate iOS Simulator workflows (simctl + idb)

Description

What This Skill Does

A Node.js CLI wrapper around xcrun simctl and idb for iOS Simulator automation. Handles device lifecycle (create, boot, erase), app install and launch, accessibility-based UI interaction, push notifications, screenshots, and privacy grants. Runs on macOS only.

Combines simctl device management and idb accessibility-tree UI automation in a single structured CLI built for AI agents, removing the need to manually coordinate between multiple tools.

When to Use It

  • Installing and launching an .app build on a simulator during development
  • Capturing screenshots automatically for App Store submission prep
  • Sending test push notifications to a running simulator
  • Granting location or camera permissions programmatically before UI tests
  • Tapping UI elements by accessibility label in a CI pipeline

Example Workflow

INPUT

User asks: install and test my iOS app in the simulator

AGENT
  1. 1

    Run health check to confirm xcrun and idb are available

  2. 2

    List simulators and select a target device with boot flag

  3. 3

    Install the .app bundle on the booted simulator

  4. 4

    Launch the app by bundle ID

  5. 5

    Capture a screenshot and save it to artifacts/screen.png

OUTPUT

App running in simulator with screenshot saved to artifacts/screen.png

Requirements

  • Xcode or Xcode Command Line Tools installed on macOS
  • idb_companion Homebrew formula via facebook/fb tap (required for UI automation)
  • fb-idb Python package via pip (required for UI automation)

Installation

clawhub install tristanmanchester/ios-simulator

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links