findmy

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

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill findmy-luckybbjason1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/apple/findmy
Command: npx skills add https://github.com/luckybbjason1/trading --skill findmy-luckybbjason1

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 the FindMy.app with AppleScript and screenshots. ## Core Features & Use Cases - Device & AirTag Location Lookup: Open FindMy, switch between Devices and Items tabs, and read locations from screenshots using vision analysis. - Peekaboo UI Automation: Use the optional peekaboo tool for annotated UI captures and precise element clicks for more reliable interaction. - Location Tracking Over Time: Periodically capture screenshots to log an AirTag's movement, such as monitoring a pet's patrol route. - Use Case: Ask "where is my cat?" and the Skill opens FindMy, selects the cat's AirTag, captures the detail view, and reports the current address and coordinates. ## Quick Start Ask the assistant to find where your AirTag or Apple device is currently located using the Find My app.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I find my AirTag location from the macOS terminal?

Apple provides no CLI for Find My, so the Skill opens FindMy.app with AppleScript, switches to the Items tab, and captures a screenshot. A vision analysis step then reads the AirTag's location, address, and coordinates from the image.

How to automate the Find My app with AppleScript?

Use `osascript -e 'tell application "FindMy" to activate'` to open the app, then System Events to click toolbar buttons like Devices or Items. For more reliable element-level interaction, install peekaboo and use its annotated capture and click commands.

Does Find My have an API or command line interface?

No, Apple does not expose any CLI or public API for Find My. The only option on macOS is UI automation of the FindMy.app combined with screenshot capture and vision-based reading of the displayed locations.

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 in the foreground during periodic capture loops.

What permissions are needed to screenshot the Find My app?

The terminal needs Screen Recording permission, granted in System Settings under Privacy and Security. Without it, `screencapture` and peekaboo cannot capture the FindMy window contents for analysis.