findmy

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

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill findmy-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill findmy-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

What problem does it solve? Apple provides no CLI or API for Find My, making it impossible to programmatically check device or AirTag locations on macOS. This Skill bridges that gap by automating the FindMy.app UI with AppleScript and reading locations from screenshots. ## Core Features & Use Cases - Device & AirTag Location Lookup: Open FindMy.app, navigate Devices or Items tabs, and capture location data via screenshots analyzed with vision tools. - Peekaboo UI Automation: Use the optional peekaboo tool for reliable element-level clicking and annotated UI captures. - Continuous Tracking: Periodically capture AirTag locations (e.g., every 5 minutes) to compile patrol routes for pets or movement history for items. - Use Case: Ask where your keys are, and the Skill opens Find My, selects the AirTag, screenshots the map, and reports the address and coordinates. ## Quick Start Ask the agent where your AirTag or Apple device is and it will open Find My, capture the screen, and report the current 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 offers no CLI for Find My, so tracking requires UI automation. Use AppleScript to activate 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 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 provides neither an API nor a CLI for Find My. The only option on macOS is UI automation of FindMy.app combined with screenshot capture and vision analysis to extract 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 visible during monitoring 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. Without it, screencapture cannot read the FindMy window contents for vision analysis.