@kainoa/simplybuild
v0.1.2
Published
Smart iOS build and deploy CLI wrapper for xcodebuildmcp
Maintainers
Readme
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+
xcodebuildmcpavailable inPATH(interactive runs can install it automatically)
Install
npm install -g @kainoa/simplybuildThen run:
simplybuild --help
sb --helpsb is the short alias and works for all the same commands as simplybuild.
Usage
simplybuild --help
simplybuild "screenager"
simplybuild --device "iPhone 15"
simplybuild --scheme MyApp
simplybuild --list-devices
simplybuild --list-projects
simplybuild --verboseBehavior
- Auto-discovers
.xcworkspaceand.xcodeprojrecursively 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
--devicename matching (case-insensitive). - Prompts once per project/device pair before physical deployment.
- Checks for
xcodebuildmcpat startup and can offer to install it in interactive mode.
Contributing
For local development:
npm install
npm run build
npm testRun from source:
node dist/cli.js --helpContributions are welcome. Anyone is free to open a PR on GitHub: https://github.com/notkainoa/SimplyBuild
