xcrun cannot find simctl on a Mac with Xcode
xcrun: error: unable to find utility "simctl", not a developer tool or in PATHShort answer
simctl ships only inside Xcode, not in the Command Line Tools package. The error means xcrun looked in a developer directory that has no simctl. Point xcode-select at your Xcode app and finish Xcode's first-launch setup.
Fix it fast
1Find out which cause you have
Print the active developer directory. If it is /Library/Developer/CommandLineTools, xcrun is not looking inside Xcode.
xcode-select -p2Match what you see, then jump to its fix
What does the error look like?
xcrun: error: unable to find utility "simctl", not a developer tool or in PATH
Cause 1 of 2
The active developer directory is the Command Line Tools
1Check
Apple says simctl is one of the tools that only ship with the Xcode app, and that you must set Xcode as the active developer directory before using them.
xcode-select -p2Fix
Switch to the Xcode app. This needs administrator rights and affects all users.
sudo xcode-select -s /Applications/Xcode.app3Verify
xcrun finds the tool.
xcrun --find simctlConfirmed by developer.apple.com
Cause 2 of 2
Xcode's first-launch components are not installed
1Check
Apple documents that running xcodebuild -runFirstLaunch installs the required system components, including the simctl utility. The status command shows whether any first-launch work is pending.
xcodebuild -checkFirstLaunchStatus; echo $?2Fix
Run the first-launch step for the selected Xcode.
sudo xcodebuild -runFirstLaunch3Verify
simctl lists simulator runtimes.
xcrun simctl list runtimesConfirmed by developer.apple.com
How do I stop it coming back?
- After installing or updating Xcode, run xcode-select -s once and the first-launch step.
- On build machines pin the Xcode path in the job setup, not in the image default.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Related fixes
Mobile apps
flutter run on iOS says Unable to boot the Simulator
Unable to boot the Simulator.
Check the simulator list first.
3 causes, each with a fixMobile apps
Cannot change the App Privacy answers in App Store Connect
Publish Your App Privacy Responses?
Only the Account Holder, Admin and App Manager roles can answer the App Privacy questions.
2 causes, each with a fixMobile apps
App record creation fails because you lack permission
You cannot add a new app in App Store Connect as a Developer or limited user
Only the Account Holder, an Admin or an App Manager can create an app record, and Apple blocks it until the Account Holder has signed the latest agreement.
3 causes, each with a fixMobile apps
You cannot find the button to pull your app back from review
No 'remove this version from review' message appears on the version page
There is no button called Reject Binary.
3 causes, each with a fixMobile apps
Your Apple Account cannot sign in to App Store Connect
Sign-in to App Store Connect is refused for an account that should have access
App Store Connect does not open to every Apple Account.
3 causes, each with a fixMobile apps
Apple rejected the app under Guideline 4.3, Design: Spam
Guideline 4.3(b) - Design - Spam
Guideline 4.3 is Apple's duplicate rule.
5 causes, each with a fix