xcode-ide workflow tools documented in v2.1.0 are not exposed via CLI

[dpearson2699]

Summary

In xcodebuildmcp v2.1.0, docs list xcode-ide CLI tools (list-tools, call-tool, bridge-status, bridge-sync, bridge-disconnect), but the actual CLI command surface does not expose xcode-ide at all.

This creates a mismatch where:

• MCP server mode appears to register xcode-ide,
• but direct CLI mode cannot invoke any xcode-ide commands.

Environment

• macOS: Darwin 25.3.0
• Xcode: 26.3 (17C529)
• xcodebuildmcp: 2.1.0
• Install methods tested:
  • Homebrew (getsentry/xcodebuildmcp)
  • npm/npx (xcodebuildmcp@2.1.0 and @latest)

Config

.xcodebuildmcp/config.yaml includes:

schemaVersion: 1
enabledWorkflows:
  - xcode-ide
  - simulator
  - simulator-management
  - logging
  - project-discovery
  - utilities
  - ui-automation
  - debugging
  - doctor
debug: true

mcpbridge is installed and available:

xcrun --find mcpbridge
# /Applications/Xcode.app/Contents/Developer/usr/bin/mcpbridge

Repro steps

1. Verify version:

xcodebuildmcp --version
# 2.1.0

2. Check top-level CLI workflows:

xcodebuildmcp --help

Observed: no xcode-ide command group listed.

3. Check tool catalog:

xcodebuildmcp tools --json | jq -r '.workflows[].workflow'

Observed workflows:

• debugging
• device
• doctor
• logging
• macos
• project-discovery
• project-scaffolding
• simulator
• simulator-management
• swift-package
• ui-automation
• utilities

Observed: xcode-ide missing.

4. Attempt to invoke documented CLI commands:

xcodebuildmcp xcode-ide list-tools
xcodebuildmcp xcode-ide bridge-status

Observed: unknown argument/command.

5. Start MCP mode with debug:

xcodebuildmcp --log-level debug mcp

Observed logs include:

• registered workflows include xcode-ide
• xcode-ide-state resource loaded

This suggests xcode-ide exists in MCP runtime but not in CLI command registration.

Expected behavior

Given docs (docs/TOOLS-CLI.md, docs/XCODE_IDE_MCPBRIDGE.md) and enabled config, CLI should expose:

• xcodebuildmcp xcode-ide list-tools
• xcodebuildmcp xcode-ide call-tool
• xcodebuildmcp xcode-ide bridge-status
• xcodebuildmcp xcode-ide bridge-sync
• xcodebuildmcp xcode-ide bridge-disconnect

Actual behavior

xcode-ide workflow is absent from CLI help/tools output and cannot be invoked, despite being documented and apparently registered in MCP mode logs.

Additional notes

Same behavior with:

• Homebrew binary
• npx -y xcodebuildmcp@2.1.0
• npx -y xcodebuildmcp@latest

So this does not seem install-method specific.