install

Additional install commands

macOS

Homebrewverified · 100%

brew install watch-sim

local Homebrew formula metadata

overview

Package summary

Command-line WatchKit application launcher

Project links

Commands and aliases

watch-sim

history

Project history and usage

watch-sim is a small command-line launcher for WatchKit applications in the iOS Simulator. It belongs to the early Apple Watch development era, when running a WatchKit app from scripts or outside Xcode required knowing how the paired iPhone and watch simulator pieces fit together.

Project history

The upstream README describes watch-sim as a command-line WatchKit application launcher for the iOS Simulator and says it required an Xcode version with WatchKit support. At the time it was written, the tool had been used successfully with Xcode 6.2 beta 5 and Xcode 6.3 beta 1.

That places watch-sim in the 2015 WatchKit beta window. Apple released WatchKit with the iOS 8.2 and Xcode 6.2 betas in November 2014, and developers were still working through simulator and launch workflow issues during the Xcode 6.2 beta cycle.

Adoption history

Public adoption evidence is thin, so watch-sim should be understood as a niche utility rather than a broad ecosystem tool. Its value was practical: early WatchKit developers wanted a command-line way to launch watch apps, especially for scripting, CI experiments, or avoiding repetitive Xcode simulator steps.

As Xcode and watchOS tooling matured, the need for a standalone WatchKit launcher narrowed. Apple's later watchOS transition documentation describes Xcode automatically creating schemes and launching separate Apple Watch and iOS simulators for watch app debugging, which reduced the space for one-off launcher helpers.

How it is used

The tool is used from the command line to launch a WatchKit app in the simulator after building it with an appropriate Xcode version. It is most relevant to old WatchKit projects and historical automation around Xcode 6-era simulator behavior.

For modern watchOS projects, developers normally use Xcode schemes, xcodebuild, and simctl-era workflows rather than watch-sim.

Why package nerds care

watch-sim is package-nerd significant mostly as a fossil from early Apple Watch tooling. It shows how package managers often preserve tiny developer workflow tools long after platform vendors fold the same workflow into official IDE or simulator commands.

Timeline

2014-11: Apple released WatchKit with iOS 8.2 and Xcode 6.2 beta tooling for developers.
2015: watch-sim documented successful use with Xcode 6.2 beta 5 and Xcode 6.3 beta 1.
Later watchOS tooling: Xcode gained more integrated watch app build, run, and debug behavior, making watch-sim a legacy niche utility.

Related projects

ios-sim is a related command-line launcher for iOS Simulator applications.
xcrun simctl and Xcode schemes are the modern Apple-provided tooling around simulator installation and launch workflows.
WatchKit and watchOS app targets are the Apple platform context for the tool.

Sources

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

narrow executable package without higher-risk signals

Signals

metadata:no-higher-risk-signals

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 11 platform targets.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

Command	Kind	Exposure	Note
`watch-sim`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version1.0.0

manager updated

local dataok

upstreamcurrent

latest detected1.0.0

https://github.com/alloy/watch-sim

infoNo package-manager update timestamp was available.low confidence

install metadata

Package metadata

Package key	brew:watch-sim
Version	1.0.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/watch-sim
Homepage	https://github.com/alloy/watch-sim
Repository	https://github.com/alloy/watch-sim
Upstream docs	https://github.com/alloy/watch-sim#readme
License	MIT
Source archive	https://github.com/alloy/watch-sim/archive/refs/tags/1.0.0.tar.gz
Bottle	available (on arm64_big_sur, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	watch-sim
Version Scheme	0
Revision	0
Head Version	HEAD
Requirements	macos xcode
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/watch-sim.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
package relationship graph
package version freshness
package-page enrichment

Install watch-sim with Homebrew