René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[Bug]: Docs/code mismatch: device list recommends --device-id, but device build rejects it","articleBody":"### Bug Description\n\nThe xcodebuildmcp device list output instructs users to run device build/test commands with a --device-id argument, but the xcodebuildmcp device build command does not actually accept that flag.\n\nThis makes the suggested next step unusable and creates confusion about how to target a specific connected device for builds.\n\n### Debug Output\n\nN/A\n\n### Editor/Client\n\nCLI\n\n### MCP Server Version\n\n2.3.0\n\n### LLM\n\nSonnet\n\n### MCP Configuration\n\n```json\n\n```\n\n### Steps to Reproduce\n\n1. Run:\n```\nxcodebuildmcp device list\n```\n2. Observe the suggested next step:\n\n```\nxcodebuildmcp device build --scheme \"SCHEME\" --device-id \"DEVICE_UDID\"\n```\n\n\n3. Run: \n\n```\nxcodebuildmcp device build --scheme \"SCHEME\" --device-id \"DEVICE_UDID\"\n```\n\n\nThe command fails with:\n\n```\nUnknown arguments: device-id, deviceId\n```\n\nIt then shows help output for device build, which does not list --device-id as a supported argument.\n\n\n\n### Expected Behavior\n\nOne of the following should be true:\n1. xcodebuildmcp device build should support --device-id, matching the guidance shown in device list, or\n2. device list should not instruct users to pass --device-id directly, and should instead clearly explain that the device must be set via session defaults first.\n\n### Actual Behavior\n\n```\n❯ xcodebuildmcp device list\nConnected Devices:\n\n✅ Available Devices:\n\n\n📱 iPhone\n   UDID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n   Model: iPhone16,1\n   Product Type: iPhone16,1\n   Platform: Unknown 26.3.1\n   CPU Architecture: arm64e\n   Connection: localNetwork\n   Developer Mode: enabled\n\nNote: Use the device ID/UDID from above when required by other tools.\nHint: Save a default device with session-set-defaults { deviceId: 'DEVICE_UDID' }.\nBefore running build/run/test/UI automation tools, set the desired device identifier in session defaults.\n\nNext steps:\n1. Build for device: xcodebuildmcp device build --scheme \"SCHEME\" --device-id \"DEVICE_UDID\"\n2. Run tests on device: xcodebuildmcp device test --scheme \"SCHEME\" --device-id \"DEVICE_UDID\"\n3. Get app path: xcodebuildmcp device get-app-path --scheme \"SCHEME\"\n\n❯ xcodebuildmcp device build --scheme \"SCHEME\" --device-id \"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\"\n device build\n\nBuild for device.\n\nTool Arguments:\n      --project-path                                                                                            [string]\n      --workspace-path                                                                                          [string]\n      --scheme                                                                                       [string] [required]\n      --configuration                                                                                           [string]\n      --derived-data-path                                                                                       [string]\n      --extra-args                                                                                               [array]\n      --prefer-xcodebuild                                                                                      [boolean]\n\nSession Defaults:\n      --profile  Override the defaults profile for this command only                                            [string]\n\nOutput Options:\n      --json    JSON object of tool args (merged with flags)                                                    [string]\n      --output  Output format                                       [string] [choices: \"text\", \"json\"] [default: \"text\"]\n\nOptions:\n  -h, --help     Show help                                                                                     [boolean]\n  -v, --version  Show version number                                                                           [boolean]\n\nUnknown arguments: device-id, deviceId\n```\n\n### Error Messages\n\n```shell\n\n```","author":{"url":"https://github.com/loftiskg","@type":"Person","name":"loftiskg"},"datePublished":"2026-03-20T16:28:29.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/287/XcodeBuildMCP/issues/287"}