Update docs

Author: cameroncooke

README.md

@@ -261,7 +261,7 @@ xcodebuildmcp mcp
 xcodebuildmcp tools
 
 # Build for simulator
-xcodebuildmcp simulator build-sim --scheme MyApp --project-path ./MyApp.xcodeproj
+xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
 ```
 
 The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See [docs/CLI.md](docs/CLI.md) for full documentation.

docs/CLI.md

@@ -32,20 +32,20 @@ xcodebuildmcp <workflow> <tool> --help
 Each tool supports `--help` for detailed options:
 
 ```bash
-xcodebuildmcp simulator build-sim --help
+xcodebuildmcp simulator build --help
 ```
 
 Common patterns:
 
 ```bash
 # Pass options as flags
-xcodebuildmcp simulator build-sim --scheme MyApp --project-path ./MyApp.xcodeproj
+xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
 
 # Pass complex options as JSON
-xcodebuildmcp simulator build-sim --json '{"scheme": "MyApp", "projectPath": "./MyApp.xcodeproj"}'
+xcodebuildmcp simulator build --json '{"scheme": "MyApp", "projectPath": "./MyApp.xcodeproj"}'
 
 # Control output format
-xcodebuildmcp simulator list-sims --output json
+xcodebuildmcp simulator list --output json
 ```
 
 ## Examples
@@ -54,46 +54,46 @@ xcodebuildmcp simulator list-sims --output json
 
 ```bash
 # Discover projects
-xcodebuildmcp simulator discover-projs
+xcodebuildmcp simulator discover-projects
 
 # List schemes
 xcodebuildmcp simulator list-schemes --project-path ./MyApp.xcodeproj
 
 # Build
-xcodebuildmcp simulator build-sim --scheme MyApp --project-path ./MyApp.xcodeproj
+xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
 
 # Boot simulator
-xcodebuildmcp simulator boot-sim --simulator-name "iPhone 17 Pro"
+xcodebuildmcp simulator boot --simulator-name "iPhone 17 Pro"
 
 # Install and launch
-xcodebuildmcp simulator install-app-sim --simulator-id <UDID> --app-path ./build/MyApp.app
+xcodebuildmcp simulator install --simulator-id <UDID> --app-path ./build/MyApp.app
 
-xcodebuildmcp simulator launch-app-sim --simulator-id <UDID> --bundle-id com.example.MyApp
+xcodebuildmcp simulator launch-app --simulator-id <UDID> --bundle-id com.example.MyApp
 
 # Or... build and run in a single command
-xcodebuildmcp simulator build-run-sim --scheme MyApp --project-path ./MyApp.xcodeproj
+xcodebuildmcp simulator build-and-run --scheme MyApp --project-path ./MyApp.xcodeproj
 ```
 
 ### Log Capture Workflow
 
 ```bash
 # Start log capture
-xcodebuildmcp logging start-sim-log-cap --simulator-id <UDID> --bundle-id com.example.MyApp
+xcodebuildmcp logging start-simulator-log-capture --simulator-id <UDID> --bundle-id com.example.MyApp
 
 > Log capture started successfully. Session ID: 51e2142a-1a99-442a-af01-0586540043df.
 
 # Stop and retrieve logs
-xcodebuildmcp logging stop-sim-log-cap --session-id <SESSION_ID>
+xcodebuildmcp logging stop-simulator-log-capture --session-id <SESSION_ID>
 ```
 
 ### Testing
 
 ```bash
 # Run all tests
-xcodebuildmcp simulator test-sim --scheme MyAppTests --project-path ./MyApp.xcodeproj
+xcodebuildmcp simulator test --scheme MyAppTests --project-path ./MyApp.xcodeproj
 
 # Run with specific simulator
-xcodebuildmcp simulator test-sim --scheme MyAppTests --simulator-name "iPhone 17 Pro"
+xcodebuildmcp simulator test --scheme MyAppTests --simulator-name "iPhone 17 Pro"
 ```
 
 For a full list of workflows and tools, see [TOOLS-CLI.md](TOOLS-CLI.md).
@@ -208,16 +208,16 @@ Total: 2 (1 running, 1 stale)
 
 ### Stateless Tools (run in-process)
 Most tools run directly without the daemon:
-- `build-sim`, `test-sim`, `clean`
-- `list-sims`, `list-schemes`, `discover-projs`
-- `boot-sim`, `install-app-sim`, `launch-app-sim` etc.
+- `build`, `test`, `clean`
+- `list`, `list-schemes`, `discover-projects`
+- `boot`, `install`, `launch-app` etc.
 
 ### Stateful Tools (require daemon)
 Some tools maintain state and route through the daemon:
-- Log capture: `start-sim-log-cap`, `stop-sim-log-cap`
-- Video recording: `record-sim-video`
-- Debugging: `debug-attach-sim`, `debug-continue`, etc.
-- Background processes: `swift-package-run`, `swift-package-stop`
+- Log capture: `start-simulator-log-capture`, `stop-simulator-log-capture`
+- Video recording: `record-video`
+- Debugging: `attach`, `continue`, etc.
+- Background processes: `run`, `stop`
 
 When you invoke a stateful tool, the daemon auto-starts if needed.
 

docs/TOOLS-CLI.md

@@ -16,88 +16,88 @@ XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups.
 ### iOS Device Development (`device`)
 **Purpose**: Complete iOS development workflow for physical devices (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). (14 tools)
 
-- `build-device` - Build for device.
+- `build` - Build for device.
 - `clean` - Clean build products.
-- `discover-projs` - Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files.
+- `discover-projects` - Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files.
 - `get-app-bundle-id` - Extract bundle id from .app.
-- `get-device-app-path` - Get device built app path.
-- `install-app-device` - Install app on device.
-- `launch-app-device` - Launch app on device.
-- `list-devices` - List connected devices.
+- `get-app-path` - Get device built app path.
+- `install` - Install app on device.
+- `launch` - Launch app on device.
+- `list` - List connected devices.
 - `list-schemes` - List Xcode schemes.
 - `show-build-settings` - Show build settings.
-- `start-device-log-cap` - Start device log capture.
-- `stop-app-device` - Stop device app.
-- `stop-device-log-cap` - Stop device app and return logs.
-- `test-device` - Test on device.
+- `start-device-log-capture` - Start device log capture.
+- `stop` - Stop device app.
+- `stop-device-log-capture` - Stop device app and return logs.
+- `test` - Test on device.
 
 
 
 ### iOS Simulator Development (`simulator`)
 **Purpose**: Complete iOS development workflow for both .xcodeproj and .xcworkspace files targeting simulators. (21 tools)
 
-- `boot-sim` - Defined in Simulator Management workflow.
-- `build-run-sim` - Build and run iOS sim.
-- `build-sim` - Build for iOS sim.
+- `boot` - Defined in Simulator Management workflow.
+- `build` - Build for iOS sim.
+- `build-and-run` - Build and run iOS sim.
 - `clean` - Defined in iOS Device Development workflow.
-- `discover-projs` - Defined in iOS Device Development workflow.
+- `discover-projects` - Defined in iOS Device Development workflow.
 - `get-app-bundle-id` - Defined in iOS Device Development workflow.
-- `get-sim-app-path` - Get sim built app path.
-- `install-app-sim` - Install app on sim.
-- `launch-app-logs-sim` - Launch sim app with logs.
-- `launch-app-sim` - Launch app on simulator.
+- `get-app-path` - Get sim built app path.
+- `install` - Install app on sim.
+- `launch-app` - Launch app on simulator.
+- `launch-app-with-logs` - Launch sim app with logs.
+- `list` - Defined in Simulator Management workflow.
 - `list-schemes` - Defined in iOS Device Development workflow.
-- `list-sims` - Defined in Simulator Management workflow.
-- `open-sim` - Defined in Simulator Management workflow.
-- `record-sim-video` - Record sim video.
+- `open` - Defined in Simulator Management workflow.
+- `record-video` - Record sim video.
 - `screenshot` - Capture screenshot.
 - `show-build-settings` - Defined in iOS Device Development workflow.
 - `snapshot-ui` - Print view hierarchy with precise view coordinates (x, y, width, height) for visible elements.
-- `start-sim-log-cap` - Defined in Log Capture workflow.
-- `stop-app-sim` - Stop sim app.
-- `stop-sim-log-cap` - Defined in Log Capture workflow.
-- `test-sim` - Test on iOS sim.
+- `start-simulator-log-capture` - Defined in Log Capture workflow.
+- `stop` - Stop sim app.
+- `stop-simulator-log-capture` - Defined in Log Capture workflow.
+- `test` - Test on iOS sim.
 
 
 
 ### LLDB Debugging (`debugging`)
 **Purpose**: Attach LLDB debugger to simulator apps, set breakpoints, inspect variables and call stacks. (8 tools)
 
-- `debug-attach-sim` - Attach LLDB to sim app.
-- `debug-breakpoint-add` - Add breakpoint.
-- `debug-breakpoint-remove` - Remove breakpoint.
-- `debug-continue` - Continue debug session.
-- `debug-detach` - Detach debugger.
-- `debug-lldb-command` - Run LLDB command.
-- `debug-stack` - Get backtrace.
-- `debug-variables` - Get frame variables.
+- `add-breakpoint` - Add breakpoint.
+- `attach` - Attach LLDB to sim app.
+- `continue` - Continue debug session.
+- `detach` - Detach debugger.
+- `lldb-command` - Run LLDB command.
+- `remove-breakpoint` - Remove breakpoint.
+- `stack` - Get backtrace.
+- `variables` - Get frame variables.
 
 
 
 ### Log Capture (`logging`)
 **Purpose**: Capture and retrieve logs from simulator and device apps. (4 tools)
 
-- `start-device-log-cap` - Defined in iOS Device Development workflow.
-- `start-sim-log-cap` - Start sim log capture.
-- `stop-device-log-cap` - Defined in iOS Device Development workflow.
-- `stop-sim-log-cap` - Stop sim app and return logs.
+- `start-device-log-capture` - Defined in iOS Device Development workflow.
+- `start-simulator-log-capture` - Start sim log capture.
+- `stop-device-log-capture` - Defined in iOS Device Development workflow.
+- `stop-simulator-log-capture` - Stop sim app and return logs.
 
 
 
 ### macOS Development (`macos`)
 **Purpose**: Complete macOS development workflow for both .xcodeproj and .xcworkspace files. Build, test, deploy, and manage macOS applications. (11 tools)
 
-- `build-macos` - Build macOS app.
-- `build-run-macos` - Build and run macOS app.
+- `build` - Build macOS app.
+- `build-and-run` - Build and run macOS app.
 - `clean` - Defined in iOS Device Development workflow.
-- `discover-projs` - Defined in iOS Device Development workflow.
-- `get-mac-app-path` - Get macOS built app path.
-- `get-mac-bundle-id` - Extract bundle id from macOS .app.
-- `launch-mac-app` - Launch macOS app.
+- `discover-projects` - Defined in iOS Device Development workflow.
+- `get-app-path` - Get macOS built app path.
+- `get-macos-bundle-id` - Extract bundle id from macOS .app.
+- `launch` - Launch macOS app.
 - `list-schemes` - Defined in iOS Device Development workflow.
 - `show-build-settings` - Defined in iOS Device Development workflow.
-- `stop-mac-app` - Stop macOS app.
-- `test-macos` - Test macOS target.
+- `stop` - Stop macOS app.
+- `test` - Test macOS target.
 
 
 
@@ -111,9 +111,9 @@ XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups.
 ### Project Discovery (`project-discovery`)
 **Purpose**: Discover and examine Xcode projects, workspaces, and Swift packages. Analyze project structure, schemes, build settings, and bundle information. (5 tools)
 
-- `discover-projs` - Defined in iOS Device Development workflow.
+- `discover-projects` - Defined in iOS Device Development workflow.
 - `get-app-bundle-id` - Defined in iOS Device Development workflow.
-- `get-mac-bundle-id` - Defined in macOS Development workflow.
+- `get-macos-bundle-id` - Defined in macOS Development workflow.
 - `list-schemes` - Defined in iOS Device Development workflow.
 - `show-build-settings` - Defined in iOS Device Development workflow.
 
@@ -122,34 +122,34 @@ XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups.
 ### Project Scaffolding (`project-scaffolding`)
 **Purpose**: Scaffold new iOS and macOS projects from templates. (2 tools)
 
-- `scaffold-ios-project` - Scaffold iOS project.
-- `scaffold-macos-project` - Scaffold macOS project.
+- `scaffold-ios` - Scaffold iOS project.
+- `scaffold-macos` - Scaffold macOS project.
 
 
 
 ### Simulator Management (`simulator-management`)
 **Purpose**: Tools for managing simulators from booting, opening simulators, listing simulators, stopping simulators, erasing simulator content and settings, and setting simulator environment options like location, network, statusbar and appearance. (8 tools)
 
-- `boot-sim` - Boot iOS simulator.
-- `erase-sims` - Erase simulator.
-- `list-sims` - List iOS simulators.
-- `open-sim` - Open Simulator app.
-- `reset-sim-location` - Reset sim location.
-- `set-sim-appearance` - Set sim appearance.
-- `set-sim-location` - Set sim location.
-- `sim-statusbar` - Set sim status bar network.
+- `boot` - Boot iOS simulator.
+- `erase` - Erase simulator.
+- `list` - List iOS simulators.
+- `open` - Open Simulator app.
+- `reset-location` - Reset sim location.
+- `set-appearance` - Set sim appearance.
+- `set-location` - Set sim location.
+- `statusbar` - Set sim status bar network.
 
 
 
 ### Swift Package Development (`swift-package`)
 **Purpose**: Build, test, run and manage Swift Package Manager projects. (6 tools)
 
-- `swift-package-build` - swift package target build.
-- `swift-package-clean` - swift package clean.
-- `swift-package-list` - List SwiftPM processes.
-- `swift-package-run` - swift package target run.
-- `swift-package-stop` - Stop SwiftPM run.
-- `swift-package-test` - Run swift package target tests.
+- `build` - swift package target build.
+- `clean` - swift package clean.
+- `list` - List SwiftPM processes.
+- `run` - swift package target run.
+- `stop` - Stop SwiftPM run.
+- `test` - Run swift package target tests.
 
 
 
@@ -173,9 +173,9 @@ XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups.
 ### Xcode IDE Integration (`xcode-ide`)
 **Purpose**: Bridge tools for connecting to Xcode's built-in MCP server (mcpbridge) to access IDE-specific functionality. (3 tools)
 
-- `xcode-tools-bridge-disconnect` - Disconnect bridge and unregister proxied `xcode_tools_*` tools.
-- `xcode-tools-bridge-status` - Show xcrun mcpbridge availability and proxy tool sync status.
-- `xcode-tools-bridge-sync` - One-shot connect + tools/list sync (manual retry; avoids background prompt spam).
+- `bridge-disconnect` - Disconnect bridge and unregister proxied `xcode_tools_*` tools.
+- `bridge-status` - Show xcrun mcpbridge availability and proxy tool sync status.
+- `bridge-sync` - One-shot connect + tools/list sync (manual retry; avoids background prompt spam).
 
 
 
@@ -187,4 +187,4 @@ XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups.
 
 ---
 
-*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-06T11:40:14.287Z UTC*
+*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-07T22:29:44.282Z UTC*

docs/TOOLS.md

@@ -202,4 +202,4 @@ This document lists MCP tool names as exposed to MCP clients. XcodeBuildMCP prov
 
 ---
 
-*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-06T11:40:14.287Z UTC*
+*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-07T22:29:44.282Z UTC*