iOS tools
Mavster needs a working Xcode install with the Command Line Tools to discover and drive iOS simulators. This page covers installing them, accepting Xcode's license, and verifying everything's in order.
To test iOS apps with Mavster, your Mac needs Xcode and the Xcode Command Line Tools. Mavster relies on Apple's standard developer tooling to discover simulators and devices, launch and terminate apps, and (when you use the agent integration) build your project.
Install or repair Command Line Tools
Run this once per Mac:
xcode-select --install
If Xcode is already installed but its command-line tools point somewhere stale, fix it with:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license accept
xcodebuild -license accept is required after a fresh install or a major Xcode upgrade — without it, Mavster's build pipeline calls will fail with the macOS license prompt.
Verify your setup
xcode-select -p # should print: /Applications/Xcode.app/Contents/Developer
xcrun simctl list devices --json | head -20 # should print JSON, not an error
If the first command points at /Library/Developer/CommandLineTools instead of an Xcode bundle, switch with the xcode-select --switch command above. Mavster needs a full Xcode install (for builds), not just the Command Line Tools.
Just testing iOS — do I really need a full Xcode?
Yes. Without a full Xcode install, simulator support won't work — the Command Line Tools alone aren't enough.
If you're targeting Android only, skip this page and see Android tools instead.