macos-desktop-control
by emptyopen
Coding Agents & IDEsBrief
A high-fidelity automation bridge for macOS (Darwin) that enables agents to perceive the desktop state and execute.
Description
What This Skill Does
Gives agents the ability to see and interact with a macOS desktop. Uses cliclick for mouse and keyboard input, and the native screencapture utility to capture the current screen state as a PNG.
Lets agents control any macOS app regardless of whether it exposes an API or CLI interface.
When to Use It
- Clicking UI buttons in apps that lack an API
- Typing into desktop application fields
- Automating repetitive GUI workflows on Mac
- Taking screenshots to verify visual state
- Moving the mouse to trigger hover-based UI elements
Example Workflow
User asks: open the Settings app and take a screenshot of the Wi-Fi panel
- 1
Calls see to capture current screen state
- 2
Identifies the Settings icon position from the screenshot
- 3
Calls click with coordinates to open Settings
- 4
Navigates to Wi-Fi using click and type commands
- 5
Calls see again to capture the Wi-Fi panel
PNG screenshot saved to /tmp/claw_view.png showing the Wi-Fi settings panel
Requirements
- cliclick installed via Homebrew (brew install cliclick)
- macOS screen recording permission granted to the terminal or agent process
Installation
clawhub install emptyopen/macos-desktop-controlRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.