feat(cli): add interactive setup wizard and modernize init command

Add `xcodebuildmcp setup` — an interactive terminal wizard that walks
users through configuring project defaults (project/workspace, scheme,
simulator, workflows, debug mode, Sentry opt-out) and persists the
result to .xcodebuildmcp/config.yaml.

Key changes:
- New setup command with clack-based interactive prompts
- Shared Prompter abstraction for testable TTY/non-interactive prompts
- Promote sentryDisabled from env-var-only to first-class config key
- Extract reusable functions from discover_projs, list_schemes, list_sims
  so both MCP tools and CLI can call them directly
- Modernize init command to use clack prompts and interactive selection
- Replace Cursor/Codex client targets with generic Agents Skills target
- Add persistProjectConfigPatch for atomic config file updates

Author: cameroncooke

config.example.yaml

@@ -3,6 +3,8 @@ enabledWorkflows: ['simulator', 'ui-automation', 'debugging']
 experimentalWorkflowDiscovery: false
 disableSessionDefaults: false
 incrementalBuildsEnabled: false
+debug: false
+sentryDisabled: false
 sessionDefaults:
   projectPath: './MyApp.xcodeproj' # xor workspacePath
   workspacePath: './MyApp.xcworkspace' # xor projectPath

docs/CLI.md

@@ -25,6 +25,9 @@ xcodebuildmcp --help
 
 # View tool help
 xcodebuildmcp <workflow> <tool> --help
+
+# Run interactive setup for .xcodebuildmcp/config.yaml
+xcodebuildmcp setup
 ```
 
 ## Tool Options
@@ -116,6 +119,8 @@ enabledWorkflows:
 
 See [CONFIGURATION.md](CONFIGURATION.md) for the full schema.
 
+To create/update config interactively, run `xcodebuildmcp setup`.
+
 ## Environment Variables
 
 | Variable | Description |

docs/CONFIGURATION.md

@@ -25,6 +25,12 @@ Create a config file at your workspace root:
 <workspace-root>/.xcodebuildmcp/config.yaml
 ```
 
+Or run the interactive setup wizard:
+
+```bash
+xcodebuildmcp setup
+```
+
 Minimal example:
 
 ```yaml
@@ -61,6 +67,7 @@ incrementalBuildsEnabled: false
 
 # Debugging
 debug: false
+sentryDisabled: false
 debuggerBackend: "dap"
 dapRequestTimeoutMs: 30000
 dapLogEvents: false
@@ -262,8 +269,13 @@ Default templates:
 By default, only internal XcodeBuildMCP runtime failures are sent to Sentry. User-domain errors (such as project build/test/config failures) are not sent. To disable telemetry entirely:
 
 ```yaml
-# Environment variable only (no config.yaml option)
-# XCODEBUILDMCP_SENTRY_DISABLED=true
+sentryDisabled: true
+```
+
+You can also disable telemetry via environment variable:
+
+```bash
+XCODEBUILDMCP_SENTRY_DISABLED=true
 ```
 
 See [PRIVACY.md](PRIVACY.md) for more information.
@@ -286,6 +298,7 @@ Notes:
 | `sessionDefaults` | object | `{}` |
 | `incrementalBuildsEnabled` | boolean | `false` |
 | `debug` | boolean | `false` |
+| `sentryDisabled` | boolean | `false` |
 | `debuggerBackend` | string | `"dap"` |
 | `dapRequestTimeoutMs` | number | `30000` |
 | `dapLogEvents` | boolean | `false` |
@@ -310,6 +323,7 @@ Environment variables are supported for backwards compatibility but the config f
 | `disableSessionDefaults` | `XCODEBUILDMCP_DISABLE_SESSION_DEFAULTS` |
 | `incrementalBuildsEnabled` | `INCREMENTAL_BUILDS_ENABLED` |
 | `debug` | `XCODEBUILDMCP_DEBUG` |
+| `sentryDisabled` | `XCODEBUILDMCP_SENTRY_DISABLED` |
 | `debuggerBackend` | `XCODEBUILDMCP_DEBUGGER_BACKEND` |
 | `dapRequestTimeoutMs` | `XCODEBUILDMCP_DAP_REQUEST_TIMEOUT_MS` |
 | `dapLogEvents` | `XCODEBUILDMCP_DAP_LOG_EVENTS` |
@@ -320,7 +334,6 @@ Environment variables are supported for backwards compatibility but the config f
 | `iosTemplateVersion` | `XCODEBUILD_MCP_IOS_TEMPLATE_VERSION` |
 | `macosTemplatePath` | `XCODEBUILDMCP_MACOS_TEMPLATE_PATH` |
 | `macosTemplateVersion` | `XCODEBUILD_MCP_MACOS_TEMPLATE_VERSION` |
-| (no config option) | `XCODEBUILDMCP_SENTRY_DISABLED` |
 
 Config file takes precedence over environment variables when both are set.
 

docs/GETTING_STARTED.md

@@ -69,6 +69,12 @@ For deterministic session defaults and runtime configuration, add a config file
 <workspace-root>/.xcodebuildmcp/config.yaml
 ```
 
+Use the setup wizard to create or update this file interactively:
+
+```bash
+xcodebuildmcp setup
+```
+
 See [CONFIGURATION.md](CONFIGURATION.md) for the full schema and examples.
 
 ## Client-specific configuration

docs/TOOLS-CLI.md

@@ -189,4 +189,4 @@ XcodeBuildMCP provides 73 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-22T18:16:55.247Z UTC*
+*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-27T19:40:32.655Z UTC*

docs/TOOLS.md

@@ -205,4 +205,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-22T18:16:55.247Z UTC*
+*This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-27T19:40:32.655Z UTC*

example_projects/iOS_Calculator/.xcodebuildmcp/config.yaml

@@ -1,11 +1,11 @@
 schemaVersion: 1
 enabledWorkflows:
+  - debugging
   - simulator
   - ui-automation
-  - debugging
   - xcode-ide
 sessionDefaults:
-  workspacePath: ./CalculatorApp.xcworkspace
+  workspacePath: CalculatorApp.xcworkspace
   scheme: CalculatorApp
   configuration: Debug
   simulatorName: iPhone 17 Pro
@@ -17,3 +17,5 @@ sessionDefaults:
   derivedDataPath: ./iOS_Calculator/.derivedData
   preferXcodebuild: true
   bundleId: io.sentry.calculatorapp
+debug: false
+sentryDisabled: false

package-lock.json

@@ -70,6 +70,7 @@
     "url": "https://github.com/getsentry/XcodeBuildMCP/issues"
   },
   "dependencies": {
+    "@clack/prompts": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@sentry/cli": "^3.1.0",
     "@sentry/node": "^10.38.0",

package.json

@@ -125,7 +125,7 @@ function extractCommandCandidates(content) {
 }
 
 function findInvalidCommands(files, validPairs, validWorkflows) {
-  const validTopLevel = new Set(['mcp', 'tools', 'daemon', 'init']);
+  const validTopLevel = new Set(['mcp', 'tools', 'daemon', 'init', 'setup']);
   const validDaemonActions = new Set(['status', 'start', 'stop', 'restart', 'list']);
   const findings = [];