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

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

/**
 * Clone iOS simulator devices with complete state preservation
 *
 * **What it does:**
 * Creates an exact duplicate of an existing simulator including all settings, installed apps,
 * and current state. The cloned simulator gets a new UDID but preserves all configuration.
 *
 * **Why you'd use it:**
 * - Snapshots create backups of configured simulators for safe experimentation
 * - Testing variants enable multiple versions for different test scenarios
 * - State preservation includes all apps, data, and configuration
 * - Quick setup duplicates existing configuration instead of manual recreation
 *
 * **Parameters:**
 * - `deviceId` (string): Source device UDID to clone (from simctl-list)
 * - `newName` (string): Display name for the cloned simulator
 *
 * **Returns:**
 * Clone status with both source and new device information, including new UDID
 *
 * **Example:**
 * ```typescript
 * // Clone simulator for testing
 * await simctlCloneTool({
 *   deviceId: 'ABC-123-DEF',
 *   newName: 'TestDevice-Snapshot'
 * })
 * ```
 *
 * **Full documentation:** See simctl/clone.md for cloning strategies and use cases
 *
 * @param args Clone configuration (requires deviceId and newName)
 * @returns Tool result with clone status, new UDID, and guidance
 * @throws McpError for invalid device ID, duplicate name, or clone failure
 */
export declare function simctlCloneTool(args: any): Promise<{
    content: {
        type: "text";
        text: string;
    }[];
    isError: boolean;
}>;
export declare const SIMCTL_CLONE_DOCS = "\n# simctl-clone\n\nClone iOS simulator devices with complete state preservation.\n\n## Overview\n\nCreates an exact duplicate of an existing simulator including all settings, installed apps, and current state. The cloned simulator gets a new UDID but preserves all configuration. Useful for creating backups of configured simulators before experiments or maintaining multiple test variants.\n\n## Parameters\n\n### Required\n- **deviceId** (string): Source device UDID to clone (from simctl-list)\n- **newName** (string): Display name for the cloned simulator\n\n## Returns\n\nClone status with both source and new device information, including new UDID, success indicator, command output, and guidance for managing the cloned device.\n\n## Examples\n\n### Clone simulator for testing\n```typescript\nawait simctlCloneTool({\n  deviceId: 'ABC-123-DEF',\n  newName: 'TestDevice-Snapshot'\n});\n```\n\n### Create backup before experiments\n```typescript\nawait simctlCloneTool({\n  deviceId: 'PRODUCTION-UDID',\n  newName: 'Production Test Backup'\n});\n```\n\n## Related Tools\n\n- simctl-list: Find source device UDID to clone\n- simctl-boot: Boot cloned device after creation\n- simctl-delete: Remove cloned device when no longer needed\n\n## Notes\n\n- Cloned device includes all apps and data from source\n- New UDID is generated automatically\n- Cloning can take 1-2 minutes depending on data size\n- Source device name and configuration are preserved\n- Device can be in any state (booted, shutdown) during clone\n";
//# sourceMappingURL=clone.d.ts.map