findmy

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

2|Updated Oct 20, 2017
One-click install
npx skills add https://github.com/rbudiharso/dotfiles --skill findmy-rbudiharso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/rbudiharso/dotfiles/tree/main/hermes/.hermes/skills/apple/findmy
Command: npx skills add https://github.com/rbudiharso/dotfiles --skill findmy-rbudiharso

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 using AppleScript and screen capture to read device locations from FindMy.app on macOS. ## 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 annotated UI captures and precise element clicks on specific devices or items. - Periodic Location Tracking: Run a capture loop to log AirTag positions over time, such as monitoring a pet's patrol route every five minutes. - Use Case: Ask where your keys are, and the Skill opens Find My, navigates to the Items tab, screenshots 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 Find My 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 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 analyze the image with a vision tool to read the 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. Combine this with screencapture to grab the window, then use vision analysis to extract device names and locations from the image.

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

No, Apple does not provide any CLI or public API for Find My. The only approach on macOS is UI automation via AppleScript and screenshot analysis, optionally enhanced with the peekaboo tool for more reliable element interaction.

Why does my AirTag location stop updating during tracking?▼

AirTags only update 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 tracking sessions.

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

The terminal needs Screen Recording permission, granted in System Settings under Privacy and Security. You also need macOS with iCloud signed in and devices or AirTags already registered in Find My.