skills.rest
harlanljones
harlanljonesCOMMUNITY
Explore all skills by this author →
GitHub

findmy

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

Updated Dec 7, 2025
Search Tags:#macos#ui automation#screenshot#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/harlanljones/dotfiles --skill findmy-harlanljones
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/harlanljones/dotfiles/tree/main/dot_hermes/skills/apple/findmy
Command: npx skills add https://github.com/harlanljones/dotfiles --skill findmy-harlanljones

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, then reading locations with vision analysis. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy.app, switch between Devices and Items tabs, and capture screenshots to read current locations. - Peekaboo UI Automation: Use the optional peekaboo tool for annotated UI captures and precise element clicks for more reliable interaction. - Continuous AirTag Tracking: Periodically screenshot an AirTag's page to log location over time, such as mapping a pet's patrol route. - Use Case: Ask where your keys are, and the Skill opens Find My, navigates to the Items tab, captures the AirTag's detail view, and reports the address and coordinates shown. ## Quick Start Ask the assistant to find the current location of your AirTag or Apple device using Find My on this Mac.

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. Open FindMy.app with AppleScript, navigate to the Items tab, capture a screenshot with screencapture, and use vision analysis to read the displayed 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 interaction, install peekaboo to annotate UI elements and click them by element ID.

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

No, Apple does not expose any API or command-line interface for Find My. All access must go through the FindMy.app GUI, which is why this approach relies on screen capture and vision-based reading.

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
azaanalirazaazaanaliraza

findmy

Track Apple devices and AirTags via FindMy.app using AppleScript and screen capture.

Community
Intermediate
jaredcroxtonjaredcroxton

findmy

Extract Apple device and AirTag locations from the Find My macOS UI via screenshots and vision analysis.

Community
Intermediate
xiaoquqixiaoquqi

findmy

Automate Find My on macOS to reveal Apple device and AirTag locations.

Community
Intermediate