findmy

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

Updated May 13, 2026
One-click install
npx skills add https://github.com/superfhp/lumi-agent-body --skill findmy-superfhp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/superfhp/lumi-agent-body/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/superfhp/lumi-agent-body --skill findmy-superfhp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Apple provides no CLI or API for Find My, so locating devices and AirTags programmatically on macOS is impossible without workarounds. This Skill bridges that gap using AppleScript UI automation and screenshot analysis to read device and AirTag locations from the FindMy app. ## Core Features & Use Cases - Device & AirTag Location Reading: Open FindMy.app via AppleScript, 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. - 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 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 track an AirTag location from the command line on macOS?▼

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 read the AirTag's location.

How to automate the Find My app with AppleScript?▼

Use osascript to activate the FindMy application 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 workaround on macOS is UI automation via AppleScript and screenshot capture, optionally enhanced with the peekaboo tool for more reliable element interaction.

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

AirTags only update their location while the FindMy page is actively displayed in the foreground. If the app is minimized, updates stop, so keep FindMy in the foreground during tracking and rely on nearby Apple devices in the Find My network for accuracy.

What permissions are needed to screenshot the Find My app?▼

Screen Recording permission is required for the terminal application, granted in System Settings under Privacy and Security. Without it, screencapture cannot capture the FindMy window contents for vision analysis.