/** * Rename iOS simulator devices for better organization * * **What it does:** * Changes the display name of a simulator without affecting its UDID or any data. * Useful for organizing and identifying simulators with descriptive names. * * **Why you'd use it:** * - Organization helps better manage and identify simulators in lists * - Easy identification enables use of descriptive names for test devices * - Data preserved means renaming does not affect UDID or stored data * - Quick operation completes instantly with no side effects * * **Parameters:** * - `deviceId` (string): Device UDID to rename (from simctl-list) * - `newName` (string): New display name for the simulator * * **Returns:** * Rename status showing old name, new name, and confirmation that UDID is unchanged * * **Example:** * ```typescript * // Rename simulator for clarity * await simctlRenameTool({ * deviceId: 'ABC-123-DEF', * newName: 'Production Test Device' * }) * ``` * * **Full documentation:** See simctl/rename.md for naming conventions and best practices * * @param args Rename configuration (requires deviceId and newName) * @returns Tool result with rename status and guidance * @throws McpError for invalid device ID, duplicate name, or rename failure */ export declare function simctlRenameTool(args: any): Promise<{ content: { type: "text"; text: string; }[]; isError: boolean; }>; export declare const SIMCTL_RENAME_DOCS = "\n# simctl-rename\n\nRename iOS simulator devices for better organization.\n\n## Overview\n\nChanges the display name of a simulator without affecting its UDID or any data. Useful for organizing and identifying simulators with descriptive names. Quick operation completes instantly with no side effects.\n\n## Parameters\n\n### Required\n- **deviceId** (string): Device UDID to rename (from simctl-list)\n- **newName** (string): New display name for the simulator\n\n## Returns\n\nRename status showing old name, new name, confirmation that UDID is unchanged, success indicator, command output, and guidance emphasizing data preservation.\n\n## Examples\n\n### Rename simulator for clarity\n```typescript\nawait simctlRenameTool({\n deviceId: 'ABC-123-DEF',\n newName: 'Production Test Device'\n});\n```\n\n### Organize test devices\n```typescript\nawait simctlRenameTool({\n deviceId: 'TEST-UDID',\n newName: 'UI Tests - iPhone 16 Pro'\n});\n```\n\n## Related Tools\n\n- simctl-list: Find device UDID to rename\n- simctl-create: Create new simulator with specific name\n- simctl-clone: Clone simulator with new name\n\n## Notes\n\n- UDID remains unchanged - only display name is modified\n- All data and configuration preserved\n- Quick operation - completes instantly\n- New name must be unique - cannot duplicate existing names\n- Use descriptive names for better organization and identification\n- Perfect for organizing test devices by purpose or team\n"; //# sourceMappingURL=rename.d.ts.map