skills.rest
jamsdoescode
jamsdoescodeCOMMUNITY
Explore all skills by this author →
GitHub

findmy

Track Apple devices and AirTags via FindMy.app using AppleScript and screenshots on macOS.

Updated Jul 7, 2026
Search Tags:#macos#ui automation#screenshot#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill findmy-jamsdoescode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/findmy
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill findmy-jamsdoescode

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 UI automation. This Skill bridges that gap by driving the 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 location data via screenshots analyzed with vision. - Peekaboo UI Automation: Use the optional peekaboo tool for annotated UI captures and precise element clicks for more reliable interaction. - Continuous AirTag Tracking: Periodically screenshot an AirTag's detail 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 the current location of your AirTag or Apple device using the Find My app 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. Use AppleScript to open FindMy.app, navigate to the Items tab, take 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. For more reliable interaction, install peekaboo via brew to capture annotated UI screenshots and click elements by ID.

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

No, Apple does not provide any API or command-line interface for Find My. The only way to read device or AirTag locations programmatically on macOS is through UI automation of the FindMy.app combined with screenshot analysis.

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 closed, updates stop, so keep FindMy in the foreground during continuous tracking sessions.

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

Screen Recording permission is required for the terminal to capture the FindMy window. Enable it in System Settings under Privacy and Security, then Screen Recording, and ensure iCloud is signed in with devices registered.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
scitixscitix
225

job-debug

Diagnose Kubernetes Job and CronJob failures using kubectl and pod logs.

Official
Intermediate
Z43LZ43L

findmy

Automate FindMy.app UI navigation to extract Apple device and AirTag locations from screenshots.

Community
Intermediate
pmcdowallpmcdowall

findmy

Automate macOS Find My app to track Apple devices and AirTags.

Community
Intermediate