skills.rest
zhoulingxiao1216
zhoulingxiao1216COMMUNITY
Explore all skills by this author →
GitHub

findmy

Track Apple devices and AirTags via FindMy.app UI automation on macOS.

Updated Jun 30, 2026
Search Tags:#macos#ui automation#screenshot#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill findmy-zhoulingxiao1216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/zhoulingxiao1216/testworkspace/tree/main/all_Skills/apple/findmy
Command: npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill findmy-zhoulingxiao1216

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Apple provides no CLI or API for Find My, making it impossible to programmatically check device or AirTag locations. This Skill bridges that gap by automating the FindMy.app UI on macOS through AppleScript and screenshots, letting you query locations conversationally. ## Core Features & Use Cases - Device & AirTag Location Lookup: Open Find My, navigate Devices or Items tabs, and read locations from screenshots using vision analysis. - UI Automation with Peekaboo: Optionally use the peekaboo tool for reliable element-level clicking and annotated UI captures. - Continuous AirTag Tracking: Periodically capture screenshots to log an AirTag's movement over time, such as mapping a pet's patrol route. - Use Case: Ask "where is my cat?" and the Skill opens Find My, selects the cat's AirTag, captures the screen, and reports the current address and coordinates. ## Quick Start Ask the assistant where your AirTag or Apple device is currently located and it will open Find My and read the location from the screen.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track an AirTag location from the command line on macOS?▼

Apple provides no CLI for Find My, so tracking requires UI automation. Use AppleScript to open FindMy.app, capture the window with screencapture, and analyze the screenshot with a vision tool to read the AirTag's location.

How to automate the Find My app with AppleScript?▼

Use osascript to activate FindMy and System Events to click toolbar buttons like Devices or Items. For more reliable element-level interaction, install peekaboo via brew and use its see, click, and image commands.

Does Find My have an API or CLI for location queries?▼

No, Apple does not expose any official API or command-line interface for Find My. The only options are UI automation through AppleScript and screenshot analysis, or unofficial private frameworks that this Skill does not use.

Why is my AirTag location not updating in Find My?▼

AirTags only refresh their location while the Find My page is actively displayed in the foreground. Keep the app open and visible during tracking, and note that accuracy depends on nearby Apple devices in the Find My network.

What permissions are needed to screenshot Find My on macOS?▼

Your terminal needs Screen Recording permission, granted in System Settings under Privacy and Security. Without it, screencapture produces blank or incomplete images of the Find My window.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

Automate the macOS Find My app to locate Apple devices and AirTags.

Community
Intermediate
tsuga-devtsuga-dev
2

tsuga-audit-monitor-coverage

Audit Tsuna monitor coverage and notification routing gaps across services and teams.

Official
Advanced
VYRE-StudiosVYRE-Studios

findmy

Capture Find My app screenshots and extract device locations via image analysis.

Official
Intermediate
HarriesHarries

findmy

Automate Find My UI to locate Apple devices and AirTags on macOS.

Community
Intermediate