Worktree iOS Dev

Use worktree-ios-dev-tool for every non-interactive iOS build or simulator task. Keep xcodebuildmcp-cli for debugging, UI automation, and log streaming.

Decision

• Build / test / run / clean / package test / wipe derived data → worktree-ios-dev-tool <verb> (top-level).
• Project lifecycle (init, inspect config, doctor) → worktree-ios-dev-tool proj <verb>.
• Simulator lifecycle (pick, boot, shutdown, list, recreate, remove, cleanup, du, prune) → worktree-ios-dev-tool sim <verb>.
• Debug sessions, breakpoints, log streaming, UI automation (tap / swipe / screenshot), archive, export IPA, TestFlight → xcodebuildmcp-cli skill.
• Never use swift test for local Swift packages — use worktree-ios-dev-tool test-package instead.

One-time machine setup

uv tool install --editable /abs/path/to/worktree-ios-dev-tool/worktree_ios_dev_tool

Requires uv on PATH and ~/.local/bin on PATH.