# serve-sim

> A CLI tool that lets you run and control Apple iOS Simulators headlessly via npx, designed for agent and automation workflows.

serve-sim is an open-source CLI tool created by Evan Bacon that brings a simple `npx serve`-style experience to Apple iOS Simulators. Licensed under Apache 2.0, it is hosted on GitHub and targets developers who need to drive simulators programmatically — particularly in headless, agent, or CI contexts.

## What It Is

serve-sim sits in the category of mobile development automation tools. Its core job is to make Apple Simulators accessible and controllable from the command line without requiring a full Xcode GUI workflow. The project describes itself as "the `npx serve` of Apple Simulators," signaling a philosophy of zero-config, instant startup similar to how `npx serve` makes static file serving trivial.

## Headless Simulator Automation

The repository is tagged with the topics `agent`, `headless`, and `ios`, which directly describe its intended use cases. Headless simulator control is valuable for:

- Running automated UI tests without a display
- Powering AI agent workflows that interact with iOS apps
- CI/CD pipelines that need to boot and control simulators programmatically
- Scripted app testing and screenshot capture

## Architecture and Language

The project is written in TypeScript and structured as a monorepo under a `packages/` directory. The primary package is `serve-sim`. Being TypeScript-first means it integrates naturally into Node.js-based toolchains and can be invoked directly via `npx` without a global install step.

## Who It's For

serve-sim targets mobile developers, QA engineers, and AI agent builders who work with iOS apps and need simulator control outside of the standard Xcode GUI. The `agent` topic tag suggests it is specifically designed to support LLM-driven or autonomous agents that need to interact with iOS simulator environments as part of a larger workflow.

## Current Status

The repository was created in April 2026 and last pushed in June 2026, indicating active early development. It has accumulated over 1,300 stars and 66 forks on GitHub, reflecting notable community interest shortly after launch. There are 21 open issues as of the last update, consistent with an actively maintained early-stage project.

## Features
- Run Apple iOS Simulators via npx with zero config
- Headless simulator control for CI/CD and agent workflows
- TypeScript-first monorepo architecture
- Apache 2.0 open-source license
- Designed for agent and autonomous system integration

## Integrations
Apple iOS Simulator, Xcode, Node.js, npx

## Platforms
MACOS, IOS, CLI

## Pricing
Open Source

## Links
- Website: https://github.com/EvanBacon/serve-sim
- Repository: https://github.com/EvanBacon/serve-sim
- EveryDev.ai: https://www.everydev.ai/tools/serve-sim