mac-control
بواسطة easonc13
Browser & Automationموجز
Control Mac via mouse/keyboard automation using cliclick and AppleScript.
الوصف
ما الذي تفعله هذه المهارة
Automates Mac UI interactions using cliclick for mouse and keyboard input, screencapture for screenshots, and AppleScript for window information. Handles coordinate scaling on Retina displays and provides patterns for clicking buttons, typing text, and navigating dialogs. Includes fallback keyboard navigation for pages that block synthetic mouse events.
Combining cliclick with AppleScript window queries lets automation find element positions dynamically rather than relying on hardcoded coordinates that break when layouts change.
متى تستخدمها
- Clicking Chrome extension toolbar buttons by screen coordinates
- Automating dialog dismissal without manual mouse interaction
- Taking and analyzing screenshots to locate UI elements before clicking
- Typing text into focused fields as part of a scripted workflow
- Navigating Google OAuth pages using Tab and Enter instead of mouse clicks
مثال على سير العمل
User asks: click the OK button in the dialog on screen
- 1
Take screenshot with screencapture -x /tmp/screen.png
- 2
Read the screenshot to locate the OK button coordinates
- 3
Click at those coordinates using cliclick c:X,Y
- 4
Take a follow-up screenshot to verify the dialog was dismissed
Dialog is dismissed and confirmation screenshot shows the updated screen state
المتطلبات
- cliclick installed at /opt/homebrew/bin/cliclick
- ImageMagick (magick) installed for color-based element detection
- Accessibility permissions granted to the terminal or Node.js process in System Settings
التثبيت
clawhub install easonc13/mac-controlشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.