macOS Desktop Control Enhanced provides system-wide desktop automation on macOS, including screenshot capture, process management, clipboard operations, syst...
--- name: macos-desktop-control-enhanced description: macOS Desktop Control Enhanced provides system-wide desktop automation on macOS, including screenshot capture, process management, clipboard operations, system information, application control (open/close), and direct mouse, keyboard, and screen interaction. Use this skill when you need to programmatically control or query the macOS desktop environment. --- # When to Use This Skill - You need to capture the screen or a region programmatically. - You need to query or control running processes. - You need to read or modify the clipboard content. - You need to retrieve system information (e.g., battery level, OS version). - You need to open, focus, or close applications by bundle ID. - You need to move the mouse, click, drag, or simulate keyboard input. - You need to integrate macOS desktop automation into larger workflows (e.g., testing, data collection, accessibility). # Overview macOS Desktop Control Enhanced offers the following core capabilities: ## 1. Screenshot - `screenshot([options])` – Capture the entire screen or a specified region; returns image path. ## 2. Process Management - `get_front_process()` – Returns information about the currently frontmost process. - `kill_process(pid)` – Terminates the process with the given PID. - `launch_app(bundle_id)` – Launches an application identified by its bundle ID. ## 3. Clipboard - `get_clipboard()` – Retrieves current clipboard text. - `set_clipboard(text)` – Overwrites the clipboard with the given text. ## 4. System Information - `get_system_info()` – Returns a dictionary with macOS version, battery level, and other relevant system metrics. ## 5. Application Control - `focus_app(bundle_id)` – Brings the specified application to the foreground. - `terminate_app(bundle_id)` – Force‑closes the application with the given bundle ID. ## 6. Mouse Control - `move_mouse(x, y)` – Moves the cursor to the given screen coordinates. - `click(x, y, button='left')` – Performs a mouse click at the given coordinates. - `drag(x1, y1, x2, y2, button='left')` – Drags from (x1, y1) to (x2, y2). ## 7. Keyboard Control - `type_text(text)` – Types the given string using the system keyboard. - `press_key(key)` – Sends a single keyboard key event. # Structure This skill follows a **Capabilities‑Based** structure, grouping functionality by core features. Each capability section lists the available functions, their purpose, and brief usage notes. # References - `references/api_reference.md` – Complete function signatures, parameter details, and return values. - `scripts/example_mouse.py` – Sample Python script demonstrating mouse movement and clicking. - `assets/example_asset.png` – Example asset showing a captured screenshot. # License MIT‑0 (Free to use, modify, and redistribute. No attribution required.)
don't have the plugin yet? install it then click "run inline in claude" again.