Track Apple devices and AirTags via FindMy.app UI automation on macOS.
npx skills add https://github.com/CHENHUI-X/toolbox --skill findmy-chenhui-x
Please help me install this Agent Skill. Skill: findmy Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/apple/findmy Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill findmy-chenhui-x
peekaboo tool for annotated UI captures and precise element clicks on specific devices or items. - Continuous AirTag Tracking: Run a periodic capture loop (e.g., every 5 minutes) to log an AirTag's movement over time, such as tracking a pet's patrol route. - Use Case: Ask "where is my cat?" and the Skill opens FindMy, navigates to the AirTag item, screenshots the map, and extracts the current address and coordinates via vision analysis. ## Quick Start Ask the assistant to find where your AirTag or Apple device is currently located using the Find My app.High-intent search queries and answers about installing and using this skill.
Apple provides no CLI for Find My, so tracking requires UI automation. Use AppleScript to open FindMy.app, navigate to the Items tab, capture a screenshot with screencapture, and analyze the image with a vision tool to extract the location.
Use osascript to activate the FindMy app and System Events to click toolbar buttons like Devices or Items. After a short delay for loading, capture the window with screencapture -w and read the contents via vision analysis.
No, Apple does not provide any CLI or public API for Find My. The only approach on macOS is UI automation of the FindMy.app combined with screenshot capture and vision-based reading of the displayed locations.
AirTags only update their location while the FindMy page is actively displayed in the foreground. If the app is minimized or the item page is closed, updates stop, so keep FindMy in the foreground during continuous tracking.
Screen Recording permission must be granted to your terminal in System Settings under Privacy. Without it, screencapture and tools like peekaboo cannot capture the FindMy window contents.
AlvaroBianoAutomate the macOS Find My app to locate Apple devices and AirTags.
omarshahineDevelop map and location features for iOS/macOS apps using MapKit and CoreLocation.
KarlinskySTrack Apple device and AirTag locations via macOS UI automation and screenshot analysis.
huidgeLocate Apple devices and AirTags on macOS via Find My automation.