skills.rest
Lento47
Lento47COMMUNITY
Explore all skills by this author →
GitHub

findmy

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

1|Updated Jun 19, 2026
Search Tags:#macos#ui automation#location tracking#applescript#peekaboo#findmy#airtag
One-click install
npx skills add https://github.com/Lento47/arcana-community --skill findmy-lento47
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Lento47/arcana-community/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/Lento47/arcana-community --skill findmy-lento47

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, screen capture, and vision analysis to read device locations from the FindMy.app on macOS. ## Core Features & Use Cases - Device and AirTag Location Reading: Open FindMy.app via AppleScript, capture screenshots, and extract locations with vision analysis. - Peekaboo UI Automation: Use the optional peekaboo tool for annotated UI captures and precise element clicks on devices or items. - Continuous AirTag Tracking: Periodically capture FindMy screenshots on a schedule to log an AirTag's movement over time, such as a pet's patrol route. - Use Case: Ask where your keys are, and the agent opens Find My, switches to the Items tab, captures the AirTag's detail view, and reports the address and coordinates. ## Quick Start Ask the agent where your AirTag or Apple device is currently located and it will open Find My and report the location.

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, capture the window with screencapture, and analyze the screenshot with a vision tool to read the AirTag's 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. For more reliable interaction, install peekaboo via brew to capture annotated UI elements and click them by element ID.

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

No, Apple does not provide any API or CLI 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 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 tracking sessions.

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

Screen Recording permission for the terminal is required, granted in System Settings under Privacy. You also need macOS with the Find My app, an iCloud account signed in, and devices or AirTags already registered.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

Automate the macOS Find My app to locate Apple devices and AirTags.

Community
Intermediate
travelinman1013travelinman1013

findmy

Track Apple devices and AirTags by reading on-screen FindMy locations via AppleScript.

Community
Intermediate
jaredcroxtonjaredcroxton

findmy

Extract Apple device and AirTag locations from the Find My macOS UI via screenshots and vision analysis.

Community
Intermediate
anilcan-karaanilcan-kara

findmy

Automate FindMy app UI to locate Apple devices and AirTags on macOS.

Community
Intermediate