run

Build and launch the Convos iOS app in a dedicated simulator.

15|3|Updated Mar 27, 2025
One-click install
npx skills add https://github.com/xmtplabs/convos-ios --skill run-xmtplabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run
Source: https://github.com/xmtplabs/convos-ios/tree/main/.pi/skills/run
Command: npx skills add https://github.com/xmtplabs/convos-ios --skill run-xmtplabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates building and launching the Convos iOS app in a dedicated simulator.

Core Features & Use Cases

  • Automatically determine the target iOS simulator from the project state or git branch, then verify its availability.
  • Build the app using xcodebuild, install it on the chosen simulator, and launch it for testing.
  • Provide a deterministic, repeatable workflow that recovers gracefully when simulators are missing or unavailable.

Quick Start

Run this skill to build and launch Convos on the worktree's dedicated simulator, automatically deriving or reading the target simulator and starting the app.

Frequently Asked Questions about run

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate building and launching an iOS app in a simulator using xcodebuild?

Automating an iOS app build and launch in a simulator involves using xcodebuild to compile the app, then simctl to install and launch it on a dedicated simulator. This skill handles the full workflow automatically, deriving the target simulator from the git branch and validating its availability before building and testing.

What's the best way to run deterministic iOS simulator tests across different environments?

Deterministic iOS simulator testing requires a repeatable workflow that reads the target simulator from the worktree state, validates its availability, and performs the build and launch sequence. This skill provides that consistent workflow, ensuring reliable build-and-run cycles across environments using xcodebuild and simctl.

How does the iOS simulator cloning fallback work when a simulator is missing?

Simulator cloning fallback activates when a required simulator is unavailable or missing. This skill recovers gracefully by cloning an existing simulator to meet the build-and-run requirements, allowing the xcodebuild and simctl workflow to continue without manual simulator creation or setup.

Can I derive the target iOS simulator directly from my git branch or worktree state?

Deriving the target iOS simulator from a git branch or worktree state is supported automatically. This skill reads the worktree state, determines the appropriate simulator, validates its availability, and proceeds with the xcodebuild and launch sequence without requiring manual simulator selection.

What should I do to re-run an iOS simulator build after a failure?

Re-running an iOS simulator build after a failure involves following guidance to reset the deterministic workflow state. This skill provides recovery instructions to re-execute the xcodebuild, install, and launch sequence, ensuring the dedicated simulator is validated and ready before attempting the build again.