findmy

Retrieve Apple device and AirTag locations by automating the macOS Find My interface and extracting coordinates from screenshots.

Updated May 26, 2026
One-click install
npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill findmy-ruiyangruiyi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/ruiyangruiyi/hermes-agent/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill findmy-ruiyangruiyi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you find the current locations of your Apple devices and AirTags when there’s no official command-line interface for Find My on macOS.

Core Features & Use Cases

  • AppleScript-based app control: Opens Find My and switches between Devices and Items to surface the information you need.
  • Screen capture + vision extraction: Uses screenshots of the Find My UI and analyzes them to read device/item locations.
  • Optional Peekaboo UI automation: Improves reliability by interacting with UI elements and capturing more precise views.
  • Use case: Periodically track an AirTag location (for example, monitoring a pet’s movement) by repeatedly capturing the screen while the relevant page is open.

Quick Start

Tell the Hermes Agent to track where your AirTag is right now by opening Find My on macOS, capturing the location screen, and extracting the coordinates from the screenshot.

Frequently Asked Questions about findmy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get Apple device location data when there is no Find My command line interface on macOS?

To get Apple device location data without a CLI, you can use AppleScript to automate the Find My UI, capture screenshots of the location screen, and extract coordinates using vision-based reading. This bypasses the need for direct API access.

Can I monitor AirTag location periodically using macOS automation?

Yes, you can monitor AirTag location periodically by using AppleScript to open Find My and repeatedly capture the screen while the Items page is active. This workflow extracts location details from screenshots for ongoing tracking.

Do I need screen recording permission to extract location details from Find My using AppleScript?

Yes, macOS screen recording permission is required to extract location details from Find My using AppleScript. The process relies on capturing screenshots of the UI and applying vision-based reading to avoid pixel-level parsing.

What is the best way to read coordinates from the Find My app without pixel-level UI parsing?

The best way to read coordinates from Find My without pixel-level parsing is capturing screenshots of the UI and applying vision-based extraction. This method reads location details directly from the captured screen image.

Does Find My automation work with both Apple devices and AirTags?

Yes, Find My automation works with both Apple devices and AirTags. AppleScript controls the Find My app to switch between Devices and Items tabs, capturing screenshots to surface the location information you need from either category.

Why use Peekaboo UI automation for Find My location lookup?

Peekaboo UI automation improves the reliability of Find My location lookup by precisely interacting with UI elements. This method captures more accurate views of the Find My screen before extracting coordinates via vision-based reading.