Commands
spmx doctor
Diagnose APFS, the Xcode and Swift toolchain, PATH shims, store integrity and Git hooks.
spmx doctorRuns a series of checks and prints PASS, WARN or FAIL for each:
- the store volume is APFS, so clones are zero-copy
- Xcode and
xcodebuildare present - the active Swift supports the LLVM CAS compilation cache
~/.spmx/shimscomes beforeflutter,xcodebuildandswiftinPATH- the store,
index.jsonand the compilation cache are valid and writable - puro or fvm are compatible with the shims
- the state of Git hooks
$ spmx doctor
spmx doctor
[✓ PASS] APFS Filesystem: Store volume uses APFS; zero-copy clonefile() CoW is enabled.
[✓ PASS] Xcode / xcodebuild: Detected Xcode 27.2 / Build version 27B52.
[✓ PASS] PATH Shims Ordering: ~/.spmx/shims precedes flutter, xcodebuild, and swift in PATH.
...
Summary: 7 passed, 0 warning(s), 0 failure(s).If a check fails, see Troubleshooting.