Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Command-line application launcher for the iOS Simulator
Objective-C Ruby C
branch: master

This branch is 123 commits behind phonegap:master

Failed to load latest commit information.
Source Fix dumb missing assignment
iPhoneSimulatorRemoteClient added support for ipad
ios-sim.xcodeproj Fixes #30 dyld: Symbol not found: _OBJC_CLASS_$_NSObject
LICENSE Add original author's copyright notice to files that had them before. Fix prefix in doc (1/2)
Rakefile Install in prefix/bin.
ios-sim.xcconfig Clean up xcconfig a bit.
ios-sim_Prefix.pch Rename iphonesim to ios-sim.


The ios-sim tool is a command-line utility that launches an iOS application on the iOS Simulator. This allows for niceties such as automated testing without having to open XCode.


  • Choose the device family to simulate, i.e. iPhone or iPad.
  • Setup environment variables.
  • Pass arguments to the application.
  • See the stdout and stderr, or redirect them to files.

See the --help option for more info.


Through homebrew:

$ brew install ios-sim

Download an archive:

$ curl -L -o
$ unzip

Or from a git clone:

$ git clone git://

Then build and install from the source root:

$ rake install prefix=/usr/local/


Original author: Landon Fuller Copyright (c) 2008-2011 Plausible Labs Cooperative, Inc. All rights reserved.

This project is available under the MIT license. See LICENSE.

Something went wrong with that request. Please try again.