skills.rest
maopujie10-sys
maopujie10-sysCOMMUNITY
Explore all skills by this author →
GitHub

findmy

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

What problem does it solve? Apple provides no CLI or API for Find My, so there is no direct way to programmatically check the location of your Apple devices or AirTags. This Skill bridges that gap by driving the FindMy.app on macOS through AppleScript and screen capture, letting an AI agent read device and item locations from the app's UI. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy, switch between Devices and Items tabs, and capture screenshots that are read with vision analysis to extract locations. - Peekaboo UI Automation: Optionally use the peekaboo tool for annotated UI captures and precise element clicks for more reliable interaction. - Periodic AirTag 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 agent opens FindMy, selects the cat's AirTag, screenshots the map, and reports the current address and coordinates. ## Quick Start Ask the agent where your AirTag or Apple device is, and it will open FindMy on your Mac, 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 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 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 screenshots and click specific elements by ID.

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

No, Apple does not provide any official 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 is my AirTag location not updating in Find My?▼

AirTags only update their location while the FindMy page is actively displayed, so keep the app in the foreground during tracking. Location accuracy also depends on nearby Apple devices in the Find My network relaying the tag's position.

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

Screen Recording permission must be granted to the terminal in System Settings under Privacy and Security. Without it, screencapture and peekaboo cannot capture the FindMy window contents for analysis.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
jamsdoescodejamsdoescode

findmy

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

Community
Intermediate
KarlinskySKarlinskyS

findmy

Track Apple device and AirTag locations via macOS UI automation and screenshot analysis.

Community
Intermediate
xiaoquqixiaoquqi

findmy

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

Community
Intermediate