findmy

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

Updated May 29, 2026
One-click install
npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill findmy-reimonsk8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Reimonsk8/hermes-9router-model-balancing/tree/main/scripts/skills/apple/findmy
Command: npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill findmy-reimonsk8

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 screen capture, 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 location details via screenshots analyzed with vision. - Peekaboo UI Automation: Use the optional peekaboo tool for reliable element-level clicking and annotated UI captures of the FindMy window. - 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 location, and reports the address and coordinates. ## Quick Start Ask the assistant to find the current location of your AirTag or Apple device using the Find My app on your 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 offers no CLI for Find My, so tracking requires UI automation. Open FindMy.app with AppleScript, navigate to the Items tab, capture the window with screencapture, and use vision analysis to read the AirTag's location from the screenshot.

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 against the FindMy app.

Does Find My tracking work on Linux or Windows?▼

No, this approach requires macOS because it automates the native FindMy.app through AppleScript and screen capture. The Mac must be signed into iCloud with devices or AirTags already registered in Find My.

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

AirTags only update their location while the FindMy page is actively displayed, so keep the app in the foreground during tracking. Location accuracy also depends on nearby Apple devices in the Find My network relaying the tag's position.

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 vision analysis.