Simply Xcode Build

simplybuild is a smart CLI wrapper around xcodebuildmcp for one-command iOS build, deploy, and launch.

Requirements

• macOS with Xcode
• Node.js 20+
• xcodebuildmcp available in PATH (interactive runs can install it automatically)

Install

npm install -g @kainoa/simplybuild

Then run:

simplybuild --help
sb --help
simplebuild --help

Aliases that resolve to the same CLI: sb, simplebuild, simple-build, simply-build, symplebuild, symplybuild, symple-build, and symply-build.

Usage

simplybuild --help
simplybuild "screenager"
simplybuild --device "iPhone 15"
simplybuild --scheme MyApp
simplybuild --list-devices
simplybuild --list-projects
simplybuild --verbose

Behavior

• Auto-discovers .xcworkspace and .xcodeproj recursively from the current directory.
• Prompts to search parent directories if no containers are found.
• Auto-discovers schemes with xcodebuild -list -json.
• Falls back to interactive Clack selectors when target selection is required.
• Requires exact --device name matching (case-insensitive).
• Prompts once per project/device pair before physical deployment.
• Checks for xcodebuildmcp at startup and can offer to install it in interactive mode.

Contributing

For local development:

npm install
npm run build
npm test

Run from source:

node dist/cli.js --help

Contributions are welcome. Anyone is free to open a PR on GitHub: https://github.com/notkainoa/SimplyBuild