skills.rest
AjayRajan05
AjayRajan05COMMUNITY
Explore all skills by this author →
WebsiteGitHub

findmy

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

5|2|Updated Mar 12, 2026
Search Tags:#macos#ui automation#screenshot#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/AjayRajan05/VoiceOS --skill findmy-ajayrajan05
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/AjayRajan05/VoiceOS/tree/main/skills/bundled/community/apple/findmy
Command: npx skills add https://github.com/AjayRajan05/VoiceOS --skill findmy-ajayrajan05

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 details via screenshots analyzed with vision. - Peekaboo UI Automation: Use the optional peekaboo tool for reliable element-level clicking and annotated UI captures. - Periodic Location Tracking: Run a capture loop (e.g., every 5 minutes) to log an AirTag's movement over time, such as monitoring a pet's patrol route. - Use Case: Ask "where is my cat?" and the Skill opens Find My, selects the AirTag on the Items tab, screenshots the map, and reports the current 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, 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 element-level interaction, install peekaboo via brew and use its see, click, and image commands.

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 option on macOS is UI automation of the FindMy.app combined with screenshot capture and vision-based analysis to extract location data.

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 left, updates stop, so keep FindMy in the foreground during monitoring.

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

The terminal needs Screen Recording permission, granted in System Settings under Privacy and Security. Without it, screencapture cannot read the FindMy window contents for vision analysis.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
kotakbiasakotakbiasa

findmy

Automate FindMy via AppleScript and screen capture to track Apple devices and AirTags on macOS.

Community
Intermediate
VYRE-StudiosVYRE-Studios

findmy

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

Official
Intermediate
xiaoquqixiaoquqi

findmy

Automate Find My on macOS to reveal Apple device and AirTag locations.

Community
Intermediate