Skip to content

Commit c74ad3d

Browse files
pocketpixelscameroncooke
authored andcommitted
docs(skill): align xcodebuildmcp CLI examples with current commands
The xcodebuildmcp skill guide contained outdated command and tool names that no longer match the installed CLI interface. This patch updates the examples to the currently supported workflow/tool names and argument shapes so agents can execute documented commands without translation or failures. Validated against live CLI output via: - xcodebuildmcp --help - xcodebuildmcp tools --json - per-workflow and per-tool --help checks for all commands referenced in SKILL.md Key updates: - Replaced deprecated names such as discover-projs/list-sims/build-run-sim/build-sim/test-sim with discover-projects/list/build-and-run/build/test - Updated device examples from list-devices/build-device/get-device-app-path/install-app-device/launch-app-device to list/build/get-app-path/install/launch - Updated logging and debugging examples to start/stop-simulator-log-capture and debugging attach - Updated macOS and scaffolding commands to build/build-and-run and scaffold-ios/scaffold-macos - Removed invalid arguments from examples (e.g. --app-path on device launch, --package-path on swift-package list) Result: SKILL.md now reflects the actual CLI tool surface and option usage for the installed xcodebuildmcp binary.
1 parent d18fbec commit c74ad3d

1 file changed

Lines changed: 22 additions & 22 deletions

File tree

skills/xcodebuildmcp-cli/SKILL.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -38,48 +38,48 @@ Notes:
3838

3939
If app and project details are not known:
4040
```bash
41-
xcodebuildmcp simulator discover-projs --workspace-root .
41+
xcodebuildmcp simulator discover-projects --workspace-root .
4242
xcodebuildmcp simulator list-schemes --project-path ./MyApp.xcodeproj
43-
xcodebuildmcp simulator list-sims
43+
xcodebuildmcp simulator list
4444
```
4545

4646
To build, install and launch the app in one command:
4747
```bash
48-
xcodebuildmcp simulator build-run-sim --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"
48+
xcodebuildmcp simulator build-and-run --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"
4949
```
5050

5151
### Build only
5252

5353
When you only need to check that there are no build errors, you can build without running the app.
5454

5555
```bash
56-
xcodebuildmcp simulator build-sim --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"
56+
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"
5757
```
5858

5959
### Run Tests
6060

61-
When you need to run tests, you can do so with the `test-sim` tool.
61+
When you need to run tests, you can do so with the `test` tool.
6262

6363
```bash
64-
xcodebuildmcp simulator test-sim --scheme MyAppTests --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"
64+
xcodebuildmcp simulator test --scheme MyAppTests --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"
6565
```
6666

6767
### Install And Launch On Physical Device
6868

6969
```bash
70-
xcodebuildmcp device list-devices
71-
xcodebuildmcp device build-device --scheme MyApp --project-path ./MyApp.xcodeproj
72-
xcodebuildmcp device get-device-app-path --scheme MyApp --project-path ./MyApp.xcodeproj
70+
xcodebuildmcp device list
71+
xcodebuildmcp device build --scheme MyApp --project-path ./MyApp.xcodeproj
72+
xcodebuildmcp device get-app-path --scheme MyApp --project-path ./MyApp.xcodeproj
7373
xcodebuildmcp device get-app-bundle-id --app-path /path/to/MyApp.app
74-
xcodebuildmcp device install-app-device --device-id DEVICE_UDID --app-path /path/to/MyApp.app
75-
xcodebuildmcp device launch-app-device --device-id DEVICE_UDID --bundle-id io.sentry.MyApp --app-path /path/to/MyApp.app
74+
xcodebuildmcp device install --device-id DEVICE_UDID --app-path /path/to/MyApp.app
75+
xcodebuildmcp device launch --device-id DEVICE_UDID --bundle-id io.sentry.MyApp
7676
```
7777

7878
### Capture Logs On Simulator
7979

8080
```bash
81-
xcodebuildmcp logging start-sim-log-cap --simulator-id SIMULATOR_UDID --bundle-id io.sentry.MyApp
82-
xcodebuildmcp logging stop-sim-log-cap --log-session-id LOG_SESSION_ID
81+
xcodebuildmcp logging start-simulator-log-capture --simulator-id SIMULATOR_UDID --bundle-id io.sentry.MyApp
82+
xcodebuildmcp logging stop-simulator-log-capture --log-session-id LOG_SESSION_ID
8383
```
8484

8585
### Debug A Running App (Simulator)
@@ -89,15 +89,15 @@ xcodebuildmcp logging stop-sim-log-cap --log-session-id LOG_SESSION_ID
8989

9090
Launch if not already running:
9191
```bash
92-
xcodebuildmcp simulator launch-app-sim --bundle-id io.sentry.MyApp --simulator-id SIMULATOR_UDID
92+
xcodebuildmcp simulator launch-app --bundle-id io.sentry.MyApp --simulator-id SIMULATOR_UDID
9393
```
9494

9595
Attach the debugger:
9696

9797
It's generally a good idea to wait for 1-2s for the app to fully launch before attaching the debugger.
9898

9999
```bash
100-
xcodebuildmcp debugging debug-attach-sim --bundle-id io.sentry.MyApp --simulator-id SIMULATOR_UDID
100+
xcodebuildmcp debugging attach --bundle-id io.sentry.MyApp --simulator-id SIMULATOR_UDID
101101
```
102102

103103
To add/remove breakpoints, inspect stack/variables, and issue arbitrary LLDB commands, view debugging help:
@@ -125,8 +125,8 @@ xcodebuildmcp ui-automation --help
125125
### macOS App Build/Run
126126

127127
```bash
128-
xcodebuildmcp macos build-macos --scheme MyMacApp --project-path ./MyMacApp.xcodeproj
129-
xcodebuildmcp macos build-run-macos --scheme MyMacApp --project-path ./MyMacApp.xcodeproj
128+
xcodebuildmcp macos build --scheme MyMacApp --project-path ./MyMacApp.xcodeproj
129+
xcodebuildmcp macos build-and-run --scheme MyMacApp --project-path ./MyMacApp.xcodeproj
130130
```
131131

132132
To see all macOS tools, view macOS help:
@@ -137,7 +137,7 @@ xcodebuildmcp macos --help
137137
### SwiftPM Package Workflows
138138

139139
```bash
140-
xcodebuildmcp swift-package list --package-path ./MyPackage
140+
xcodebuildmcp swift-package list
141141
xcodebuildmcp swift-package build --package-path ./MyPackage
142142
xcodebuildmcp swift-package test --package-path ./MyPackage
143143
```
@@ -150,7 +150,7 @@ xcodebuildmcp swift-package --help
150150
### Project Discovery
151151

152152
```bash
153-
xcodebuildmcp project-discovery discover-projs --workspace-root .
153+
xcodebuildmcp project-discovery discover-projects --workspace-root .
154154
xcodebuildmcp project-discovery list-schemes --project-path ./MyApp.xcodeproj
155155
xcodebuildmcp project-discovery get-app-bundle-id --app-path ./Build/MyApp.app
156156
```
@@ -166,8 +166,8 @@ It's worth viewing the --help for the scaffolding tools to see the available opt
166166
Here are some minimal examples:
167167

168168
```bash
169-
xcodebuildmcp project-scaffolding scaffold-ios-project --project-name MyApp --output-path ./Projects
170-
xcodebuildmcp project-scaffolding scaffold-macos-project --project-name MyMacApp --output-path ./Projects
169+
xcodebuildmcp project-scaffolding scaffold-ios --project-name MyApp --output-path ./Projects
170+
xcodebuildmcp project-scaffolding scaffold-macos --project-name MyMacApp --output-path ./Projects
171171
```
172172

173173
To see all project scaffolding tools, view project scaffolding help:
@@ -187,4 +187,4 @@ xcodebuildmcp daemon restart
187187
To see all daemon commands, view daemon help:
188188
```bash
189189
xcodebuildmcp daemon --help
190-
```
190+
```

0 commit comments

Comments
 (0)