macos-computer-use

Automates macOS desktop interactions via screenshots, element indexing, and background input routing.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill macos-computer-use-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macos-computer-use
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/skills/apple/macos-computer-use
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill macos-computer-use-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automating native macOS applications normally requires moving the user's cursor, stealing keyboard focus, or switching Spaces, which interrupts the user's own work. This Skill drives the Mac desktop entirely in the background using the computer_use tool, so GUI automation runs without disturbing the active session. ## Core Features & Use Cases - Element-indexed interaction: Capture screenshots with numbered overlays and an accessibility tree, then click, drag, or scroll by element index instead of fragile pixel coordinates. - Background input routing: Click, type, scroll, and send keyboard shortcuts to any app on any Space without raising windows or moving the user's cursor. - Safety guardrails: Hard rules block interaction with permission dialogs, password prompts, payment UI, and prompt-injection content found in screenshots. - Use Case: Ask the agent to fill out a form in a native Mac app like Mail or Finder while you keep typing in your editor; the agent captures the app, clicks elements by index, and verifies each step with follow-up screenshots. ## Quick Start Use the computer_use tool to capture Safari with SOM mode, then click the Sign In element by its index and show me the result.

Frequently Asked Questions about macos-computer-use

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS desktop apps without moving the cursor?▼

Use the computer_use tool, which routes input to apps in the background without raising windows or switching Spaces. Capture the target app with mode="som", then click elements by their numbered index from the accessibility tree.

How to click UI elements reliably with computer vision automation?▼

Click by element index rather than pixel coordinates. The SOM capture mode returns numbered overlays plus an AX-tree index, so computer_use(action="click", element=7) targets the exact accessibility element even if the layout shifts slightly.

Does macOS computer use automation work with any AI model?▼

Yes, it works with any tool-capable model including Claude, GPT, Gemini, or open models via local OpenAI-compatible endpoints. There is no Anthropic-native schema; element-index clicking is reliable across models.

When should I use computer_use instead of browser automation tools?▼

Use browser_* tools for web automation since headless Chromium is more reliable than driving a GUI browser. Reserve computer_use for tasks requiring native Mac apps like Mail, Messages, Finder, Figma, or games.

Why does computer_use report cua-driver not installed?▼

The cua-driver dependency is missing. Run anakot tools and enable Computer Use, which installs cua-driver via its upstream script. macOS Accessibility and Screen Recording permissions are also required.

What actions are blocked by macOS computer use safety rules?▼

The tool blocks clicking permission dialogs, password prompts, payment UI, and 2FA challenges, and never types passwords or secrets. Dangerous shell patterns in type text and shortcuts like log out or lock screen are hard-blocked.