skills.rest
GreenyZA
GreenyZACOMMUNITY
Explore all skills by this author →
GitHub

findmy

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

Updated Sep 20, 2026
Search Tags:#macos#ui automation#apple#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/GreenyZA/neo-light --skill findmy-greenyza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/GreenyZA/neo-light/tree/main/.hermes-home/skills/apple/findmy
Command: npx skills add https://github.com/GreenyZA/neo-light --skill findmy-greenyza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Apple provides no CLI or API for Find My, so locating devices and AirTags from a terminal or agent workflow is impossible without UI automation. This Skill bridges that gap by driving FindMy.app with AppleScript and screenshots. ## Core Features & Use Cases - Device and AirTag Location Reading: Open FindMy.app, switch between Devices and Items tabs, and capture screenshots for vision-based location extraction. - Peekaboo UI Automation: Use the optional peekaboo tool for reliable element-level clicking and annotated UI captures. - Continuous Tracking: Periodically screenshot an AirTag's page to log locations over time and compile patrol routes, e.g., tracking a cat's movements every 5 minutes. ## Quick Start Ask the agent to open Find My on this Mac and tell you where your AirTag or iPhone is currently located.

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 offers no CLI for Find My, so tracking uses AppleScript to open FindMy.app, then screencapture to grab the window. A vision model reads the screenshot to extract the AirTag's location and address.

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 targeting, install peekaboo via brew and use its see and click commands with annotated UI captures.

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

No, Apple provides neither an API nor a CLI for Find My. The only option is UI automation of FindMy.app combined with screenshot analysis, which is why Screen Recording permission is required.

Why does my AirTag location stop updating during tracking?▼

AirTags only refresh their location while the FindMy page is actively displayed in the foreground. If the app is minimized or the page is left, updates stop, so keep FindMy visible during monitoring sessions.

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

The terminal needs Screen Recording permission, granted in System Settings under Privacy. Without it, screencapture cannot read the FindMy window contents for vision analysis.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
lucasfthlucasfth

findmy-device-locator

Extract device names, locations, and timestamps from FindMy map screenshots using OCR.

Community
Intermediate
devMoezdevMoez
1

findmy

Automate the Find My macOS UI to extract Apple device and AirTag locations.

Community
Intermediate
Simon-Copilot-StudioSimon-Copilot-Studio

findmy

Automate locating Apple devices and AirTags via Find My UI.

Community
Intermediate