Skip to content
This repository

Command-line application launcher for the iOS Simulator

branch: master


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.


With node.js (at least 0.10.20):

$ sudo npm install ios-sim -g

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/


When you want to release a version, do:

$ rake version:bump v=NEW_VERSION
$ rake release
$ npm version NEW_VERSION -m "Updated to npm version %s"


To get ios-sim to launch correctly within tmux use the reattach-to-user-namespace wrapper.

reattach-to-user-namespace ios-sim launch ./build/


brew: brew install reattach-to-user-namespace


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.