findmy

Automate macOS Find My app interactions to extract Apple device and AirTag locations.

19|4|Updated Apr 22, 2026

Search Tags:#macos #screen capture #location tracking #applescript #airtag #find my #vision analyze

Ready to run

npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill findmy-carterwayneskhizeine

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/carterwayneskhizeine/hermes-agent-windows-R/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill findmy-carterwayneskhizeine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo (optional), and includes assets (resource) components.

What problem does it solve?

This Skill helps you find where your Apple devices or AirTags are located by automating access to the macOS Find My app, even though Apple provides no official CLI or API for it.

Core Features & Use Cases

Device and AirTag location lookup: Open FindMy, navigate between Devices and Items, and extract what’s shown in the UI.
Screen-based location reading: Capture the Find My window and use vision to interpret the displayed location details.
Optional UI automation: Use peekaboo for more reliable clicks and annotated UI capture when screen layouts change.
Use Case: Ask for a specific device (e.g., “Where is my AirTag?”) or monitor an AirTag over time by periodically capturing screenshots and analyzing them.

Quick Start

Open FindMy and track a specific AirTag location by asking: "Where is my AirTag and what location/address is currently shown in FindMy?"

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 macOS command line?▼

You can track an AirTag location from the command line by using AppleScript to automate the macOS Find My app, capturing a screenshot of the window, and analyzing the image to extract the displayed location details.

Can I automate Find My app interactions to monitor Apple device locations over time?▼

Yes, you can automate Find My app interactions for periodic monitoring by setting up repeated screenshot captures and vision-based analysis workflows to track the movement of Apple devices and AirTags over time.

Do I need Screen Recording permissions to extract location details from the Find My app?▼

Yes, Screen Recording permissions are required to extract location details from the Find My app, because the Skill relies on capturing the UI window and using vision analysis to read the displayed text.

What is the best way to read AirTag location data when Apple provides no official API?▼

The best way to read AirTag location data without an official API is to use AppleScript UI automation to navigate the Find My app, capture the screen, and apply vision analysis to interpret the location information.

Does the peekaboo dependency improve AppleScript UI automation for Find My?▼

Yes, the optional peekaboo dependency improves AppleScript UI automation by providing more reliable clicks and annotated UI capture, which helps when navigating between Devices and Items in the Find My app.

Why does my Find My screen capture return blank or inaccurate location results?▼

Blank or inaccurate location results during Find My screen capture usually occur if macOS Screen Recording permissions are not granted or if the AppleScript UI automation fails to properly navigate to the specific device or item tab.