# Install bluepill with Homebrew, winget

Testing tool for iOS that runs UI tests using multiple simulators. Version 5.13.0 via Homebrew; verified from local package data. Also installable with winget: winget install --id Ukhirani.Bp -e.

## Install

```sh
sudo av install brew:bluepill
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bluepill
```

  Evidence: local Homebrew formula metadata

### Windows

- winget (92%):

```sh
winget install --id Ukhirani.Bp -e
```

  Evidence: Windows Package Manager source index: Ukhirani.Bp from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:bluepill
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/bluepill>
- **Version:** 5.13.0
- **Source summary:** Testing tool for iOS that runs UI tests using multiple simulators
- **Homepage:** <https://github.com/MobileNativeFoundation/bluepill>
- **Repository:** <https://github.com/MobileNativeFoundation/bluepill>
- **Upstream docs:** <https://github.com/MobileNativeFoundation/bluepill#readme>
- **License:** BSD-2-Clause
- **Source archive:** <https://github.com/MobileNativeFoundation/bluepill.git>
- **Generated:** 2026-07-26T07:20:29+00:00

## Executables

- bluepill (cli)
- bp (cli)
- bluepill (alias)
- bp (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-26
- Package-manager version: 5.13.0
- Local data: ok
- Upstream repository: https://github.com/MobileNativeFoundation/bluepill
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Bluepill is an iOS test runner created at LinkedIn to run large XCTest and UI-test suites across multiple simulators on one Mac. It became a recognizable package for iOS CI teams because it attacked the slow, flaky simulator-test problem before Apple's own parallel-test story was mature.

### Project history

LinkedIn open-sourced Bluepill in January 2017 after building it to run its large iOS test suite in a reasonable amount of time. The README describes its core features: parallel simulator execution, automatic test grouping, headless mode, junit reports, retry behavior, and simulator crash or hang recovery.

The project was originally published under LinkedIn's GitHub organization and later lives under MobileNativeFoundation. Its tags show a long 5.x release line, and the README tracks supported Xcode versions with branches for older Xcode releases.

### Adoption history

Bluepill found adoption among iOS teams that needed faster CI feedback without rewriting tests. The README explicitly documents Homebrew installation, release binaries, Fastlane plugin integrations, and a Bitrise build/test step, showing that usage spread through common mobile CI packaging channels.

The surrounding ecosystem included Redpill and other Fastlane plugins, plus Bitrise support, which let teams wire Bluepill into existing build pipelines rather than treating it as a standalone experiment.

### How it is used

A typical workflow builds an app and test bundle with xcodebuild build-for-testing, then invokes bluepill with the generated .xctestrun file and an output directory. The tool can also read a JSON configuration file via -c/--config, but the README documents this as a user-supplied file rather than a fixed config path.

Operationally, Bluepill matters because it packs tests into simulator groups, controls retry behavior, collects junit output, and can run headless to reduce resource use on CI machines.

### Why package nerds care

Bluepill is significant because it packages a hard local-platform problem: reproducible iOS simulator parallelism. For package nerds, it is a case study in a CLI wrapping Xcode artifacts, Simulator behavior, junit reporting, and CI integration into something installable with Homebrew.

It also marks a particular era of iOS infrastructure, when teams combined xctool, FBSimulatorControl ideas, Fastlane plugins, and custom runners to make Apple-platform testing scale in CI.

### Timeline

- 2017: LinkedIn open-sourced Bluepill and published early v0.x tags.
- 2017: README credits inspiration from parallel_ios_tests, Facebook xctool, and FBSimulatorControl.
- 2017-2018: Fastlane and Bitrise integrations appeared around the project ecosystem.
- 2024: Official repository metadata and tags show continued releases through the 5.x line, including Xcode 15.1-era work.

### Related projects

- parallel_ios_tests inspired the project.
- Facebook xctool and FBSimulatorControl are credited by the README as inspirations.
- Fastlane plugins such as Redpill, fastlane-plugin-bluepill, Bluepillar, and XBluepill integrated Bluepill into mobile release workflows.
- Bitrise's Bluepill Build/Test for iOS step connected it to hosted CI.

### Sources

- <https://engineering.linkedin.com/blog/2017/01/open-sourcing-bluepill--run-ios-tests-in-multiple-simulators>
- <https://github.com/MobileNativeFoundation/bluepill#readme>
- <https://github.com/MobileNativeFoundation/bluepill/releases>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bluepill
- **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

## Other Package-Manager Records

- winget - Ukhirani.Bp: installed executable or alias match | Windows Package Manager source index: Ukhirani.Bp from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [cocoapods](https://www.automicvault.com/pkg/brew/cocoapods/) - Shares av.db curated category or tags: cli, developer-tools, ios, xcode.
- [flank](https://www.automicvault.com/pkg/brew/flank/) - Shares av.db curated category or tags: cli, developer-tools, ios, testing.
- [ios-sim](https://www.automicvault.com/pkg/brew/ios-sim/) - Shares av.db curated category or tags: cli, developer-tools, ios, xcode.
- [licenseplist](https://www.automicvault.com/pkg/brew/licenseplist/) - Shares av.db curated category or tags: cli, developer-tools, ios, xcode.
- [objc-codegenutils](https://www.automicvault.com/pkg/brew/objc-codegenutils/) - Shares av.db curated category or tags: cli, developer-tools, ios, xcode.
- [xctesthtmlreport](https://www.automicvault.com/pkg/brew/xctesthtmlreport/) - Shares av.db curated category or tags: cli, developer-tools, ui-testing, xcode.
- [adb-enhanced](https://www.automicvault.com/pkg/brew/adb-enhanced/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [allure](https://www.automicvault.com/pkg/brew/allure/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [vscode-extension-tester](https://www.automicvault.com/pkg/npm/vscode-extension-tester/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, testing, tests.

## Combined YAML source

View the package source record on GitHub. [combined/bluepill.yml](https://github.com/automic-vault/db/blob/main/combined/bluepill.yml)


## Sources

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