Add platform-aware setup wizard by ichoosetoaccept · Pull Request #1 · detailobsessed/XcodeBuildMCP

ichoosetoaccept · 2026-03-17T16:51:00Z

Adds a platform selection step to the xcodebuildmcp setup wizard. Users now choose which platforms they are targeting (macOS, iOS, tvOS, watchOS, visionOS) before selecting workflows.

What this does

Platform selection prompt: Multi-select at the start of the wizard. Defaults to inferring from existing config or falling back to iOS.
Workflow pre-seeding: Wizard pre-selects the appropriate workflow set based on chosen platforms via PLATFORM_WORKFLOWS map.
Simulator skip for macOS-only: When macOS is the only platform, the simulator prompt is skipped entirely (macOS apps run natively).
Platform in config/env: When a single platform is selected, platform is written to sessionDefaults in config.yaml and XCODEBUILDMCP_PLATFORM is included in --format mcp-json output. Multi-platform omits it so the agent can choose per-command.
Remembers previous choices: Re-running the wizard pre-loads existing config.yaml values including the new platform field.

Integration with upstream device selection

This integrates cleanly with upstream's workflow-driven simulator/device gating (requiresSimulatorDefault, requiresDeviceDefault): platforms drive workflow pre-seeding, workflows drive whether simulator/device prompts appear. The platformFilter is passed to selectSimulator to filter available simulators by the selected platform when a single non-macOS platform is chosen.

Tests

Four new test cases in setup.test.ts:

macOS-only: skips simulator prompt, writes platform: macOS to config
macOS-only mcp-json: XCODEBUILDMCP_PLATFORM=macOS, no simulator fields
iOS-only mcp-json: XCODEBUILDMCP_PLATFORM=iOS Simulator + simulator fields
Multi-platform mcp-json: no XCODEBUILDMCP_PLATFORM, simulator fields present

All 1495 tests pass.

Introduce platform selection to the setup wizard, recommend workflows per platform, and avoid prompting for a simulator when macOS is the only platform selected. Add helpers and constants (SetupPlatform, PLATFORM_WORKFLOWS, PLATFORM_OPTIONS, infer/derive/filter helpers), a multi-select platform prompt, and make the setup flow platform-aware (seed workflow defaults, filter simulators, preserve platform in sessionDefaults). Add selectionToMcpConfigJson() and a --format mcp-json option to print a ready-to-paste MCP client config JSON block (runSetupWizard supports 'mcp-json' early-exit). Update tests (createPlatformPrompter and four platform-aware cases) and CHANGELOG.md to document the new behavior.