Skip to content

Conversation

@pocketpixels
Copy link

@pocketpixels pocketpixels commented Feb 11, 2026

I noticed that many of the tool names in the CLI agent skill were wrong(/outdated), making the skill less than helpful.
I had codex update it using this prompt (using the installed 2.0.7 CLI tool):
"Use the installed xcodebuildmcp CLI tool to explore its available tools and options and fix any mistakes in SKILL.md that don't line up with what is available in the actual CLI tool."


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.

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.
@pocketpixels pocketpixels changed the title docs(skill): align xcodebuildmcp CLI examples with current commands Fix outdated tool names and parameters in CLI skill Feb 11, 2026
@pocketpixels pocketpixels marked this pull request as ready for review February 11, 2026 22:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant