skills.rest
loteiron
loteironCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

findmy

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

Updated Sep 10, 2026
Search Tags:#macOS#UI automation#screenshot#location tracking#applescript#FindMy#airtag
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill findmy-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/loteiron/ZeusAgent/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill findmy-loteiron

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 FindMy.app with AppleScript and reading locations from screenshots. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy.app, switch between Devices and Items tabs, and capture screenshots for vision-based location reading. - Peekaboo UI Automation: Use the optional peekaboo tool to annotate UI elements and click specific devices or items for detail views. - Continuous AirTag Tracking: Periodically capture FindMy screenshots on a schedule to log an AirTag's movement over time, such as mapping a pet's patrol route. - Use Case: Ask where your keys are, and the agent opens Find My, selects the AirTag, captures the detail view, and reports the address and coordinates shown. ## Quick Start Ask the agent where your AirTag or Apple device is and it will open FindMy.app, capture the screen, 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 terminal on macOS?▼

Apple offers no CLI for Find My, so tracking uses AppleScript to open FindMy.app and screencapture to grab the window. A vision analysis step then reads the device location, address, and coordinates from the screenshot.

How to automate FindMy.app with AppleScript?▼

Use osascript to activate FindMy and System Events to click the Devices or Items toolbar buttons. After a short sleep for loading, capture the window with screencapture -w and analyze the image to extract locations.

Does Find My have an API or command line interface?▼

No, Find My has no official CLI or API, which is why UI automation is required. The Skill works around this by combining AppleScript, screenshots, and vision analysis, optionally using peekaboo for more reliable element interaction.

Why does my AirTag location stop updating in Find My?▼

AirTags only update their location while the FindMy page is actively displayed in the foreground. Keep the app open and unminimized during tracking, and use a periodic capture loop or cronjob to log locations over time.

What permissions are needed to screenshot FindMy.app on macOS?▼

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

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
superfhpsuperfhp

findmy

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

Community
Intermediate
VYRE-StudiosVYRE-Studios

findmy

Capture Find My app screenshots and extract device locations via image analysis.

Official
Intermediate
granietgraniet
247

findmy

Track Apple device and AirTag locations via FindMy.app UI automation.

Community
Intermediate