Skip to content
TakoAPI
Back to skills

mac-use

by kekejun

Browser & Automation
2.1kDownloads reported by clawskills.sh
3Stars
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Control macOS GUI apps visually — take screenshots, click, scroll, type.

Description

What This Skill Does

Controls macOS GUI applications through a screenshot-then-interact loop. Takes annotated screenshots using Apple Vision OCR to detect and number text elements, then clicks, types, scrolls, or presses keys based on what's visible on screen. Works with any app that has a graphical interface.

Unlike AppleScript or accessibility APIs, this works on any app regardless of whether it exposes automation hooks, since it operates purely on what's visible on screen.

When to Use It

  • Automating repetitive clicks in desktop apps without scripting APIs
  • Filling out forms in apps that lack command-line access
  • Navigating WeChat mini-programs or other sandboxed GUI environments
  • Scraping data visible on screen from apps with no export option
  • Testing desktop app UI flows end-to-end

Example Workflow

INPUT

User asks: open Safari, go to example.com, and click the first link

AGENT
  1. 1

    Run open -a Safari and wait 2 seconds

  2. 2

    Run screenshot command on Safari, read annotated image at /tmp/mac_use.png and element list JSON

  3. 3

    Identify address bar element number from OCR output, click it with clicknum

  4. 4

    Type the URL and press return key, wait for page to load

  5. 5

    Screenshot again, identify first link by element number, click it with clicknum

OUTPUT

Safari navigates to example.com and opens the first link on the page

Installation

clawhub install kekejun/mac-use

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links