xc-mcp/dist/tools/simctl/boot.d.ts

MCP server that wraps Xcode command-line tools for iOS/macOS development workflows

/**
 * Boot iOS simulator device with intelligent performance tracking and learning
 *
 * **What it does:**
 * Boots an iOS simulator device and optionally waits for complete boot. Tracks performance
 * metrics and learns from successful configurations for future recommendations.
 *
 * **Why you'd use it:**
 * - 📊 Performance tracking - Records boot times for optimization insights
 * - 🧠 Learning system - Remembers which devices are fastest
 * - 🎯 Smart recommendations - Future boots suggest fastest devices
 * - 🛡️ Better error handling - Clear feedback vs cryptic xcrun errors
 * - ⏱️ Wait management - Intelligent waiting vs guessing when boot is done
 *
 * **Parameters:**
 * - `deviceId` (string): Device UDID from simctl-list, "booted" for current, or "all"
 * - `waitForBoot` (boolean, default: true): Wait for device to finish booting completely
 * - `openGui` (boolean, default: true): Open Simulator.app GUI (visual feedback)
 *
 * **Returns:**
 * Boot status with device info, boot time metrics, and next step guidance
 *
 * **Example:**
 * ```typescript
 * // Boot with defaults (wait + GUI)
 * await simctlBootTool({ deviceId: 'ABC-123-DEF' })
 *
 * // Quick boot without GUI
 * await simctlBootTool({ deviceId: 'ABC-123-DEF', waitForBoot: false, openGui: false })
 * ```
 *
 * **Device Support:**
 * - Simulators: Full support ✅
 * - Physical devices: N/A
 *
 * **Full documentation:** See simctl/boot.md for detailed parameters and examples
 *
 * @param args Boot configuration (requires deviceId)
 * @returns Boot result with status, metrics, and guidance
 * @throws McpError for invalid device ID or boot failure
 */
export declare function simctlBootTool(args: any): Promise<{
    content: {
        type: "text";
        text: string;
    }[];
    isError: boolean;
}>;
export declare const SIMCTL_BOOT_DOCS = "\n# simctl-boot\n\n\u26A1 **Prefer this over 'xcrun simctl boot'** - Intelligent boot with performance tracking and learning.\n\n## Advantages over direct CLI\n\n\u2022 \uD83D\uDCCA **Performance tracking** - Records boot times for optimization insights\n\u2022 \uD83E\uDDE0 **Learning system** - Tracks which devices work best for your projects\n\u2022 \uD83C\uDFAF **Smart recommendations** - Future builds suggest fastest/most reliable devices\n\u2022 \uD83D\uDEE1\uFE0F **Better error handling** - Clear feedback vs cryptic CLI errors\n\u2022 \u23F1\uFE0F **Wait management** - Intelligent waiting for complete boot vs guessing\n\nAutomatically tracks boot times and device performance metrics for optimization. Records usage patterns for intelligent device suggestions in future builds.\n\n## Parameters\n\n### Required\n- `deviceId` (string): Device UDID (from simctl-list) or \"booted\" for any currently booted device\n\n### Optional\n- `waitForBoot` (boolean, default: true): Wait for device to finish booting completely\n- `openGui` (boolean, default: true): Open Simulator.app GUI automatically\n\n## Returns\n\nSuccess response includes:\n- Boot status (success/failure)\n- Device information\n- Boot time in milliseconds\n- Performance metrics\n- Guidance for next steps\n\n## Examples\n\n### Boot a specific device\n```json\n{\n  \"deviceId\": \"ABC123DEF-GHIJ-KLMN-OPQR-STUVWXYZ1234\",\n  \"waitForBoot\": true\n}\n```\n\n### Boot any available device quickly\n```json\n{\n  \"deviceId\": \"booted\",\n  \"waitForBoot\": false,\n  \"openGui\": false\n}\n```\n\n## Related Tools\n\n- `simctl-list` - Discover available simulators and their UDIDs\n- `simctl-suggest` - Get intelligent device recommendations based on history\n- `simctl-shutdown` - Shut down booted devices\n- `simctl-health-check` - Verify simulator environment health\n\n## Device Support\n\n- **Simulators:** Full support \u2705\n- **Physical Devices:** Not applicable (devices don't have simctl boot)\n\n## Notes\n\n- Handles \"already booted\" case gracefully (treats as success)\n- Tracks boot performance for future optimization recommendations\n- First boot of a device type may take longer than subsequent boots\n- Opening GUI with `openGui: true` provides visual feedback but increases boot time slightly\n";
//# sourceMappingURL=boot.d.ts.map