Guides
Xcode native projects
Use spmx with xcodebuild, Swift packages and the Xcode app.
From the terminal
With the shims on your PATH, nothing changes:
xcodebuild -workspace App.xcworkspace -scheme App build
swift build
swift testThe xcodebuild shim hydrates DerivedData/.../SourcePackages before running Xcode's tool and harvests afterwards. If you pass -clonedSourcePackagesDirPath yourself, spmx treats that as an explicit choice and does not hydrate.
On Xcode 16+ and Swift 6+ it also enables the shared compilation cache unless you set SPMX_NO_COMPILE_CACHE=1 or pass your own cache flags.
From the Xcode app
Xcode does not read your shell PATH, so shims cannot intercept a project opened from Finder or the Dock. Pre-warm instead:
spmx hooks enable --globalNow git worktree add hydrates the new worktree before you open it. See spmx hooks.
Checking one project
spmx status # type, toolchain, paths, cached pins
spmx derived-data-path App.xcworkspace