macOS Desktop Control Enhanced

---

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.)