findmy

Automate Find My app access on macOS to extract Apple device and AirTag locations from screenshots.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you locate your Apple devices and AirTags when there is no command-line or API interface for Find My, by automating Find My UI access and reading on-screen location details.

Core Features & Use Cases

  • AppleScript-driven navigation: Opens Find My and switches between Devices and Items (AirTags) using macOS AppleScript.
  • Screen capture + visual understanding: Uses screenshots to extract which device/item is shown and where it is located.
  • Optional Peekaboo UI automation: Improves interaction reliability for clicking and capturing detail views.
  • Use Case: Track an AirTag over time by periodically capturing the Find My page and extracting location updates from each screenshot.

Quick Start

Ask the Hermes Agent to track your AirTag location on macOS using FindMy.app screen captures and location extraction.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I find my AirTag location on macOS without using a CLI or API?

You can find your AirTag location on macOS by using AppleScript UI automation to open Find My, capture screenshots, and visually extract the displayed location details without needing a CLI or API.

Can I monitor an AirTag's location over time on a Mac?

You can track Apple devices over time by repeatedly capturing the Find My app screen and analyzing the extracted location details from each screenshot to monitor movement.

Do I need screen recording permission to automate Find My on macOS?

Yes, automating Find My on macOS requires screen recording permission to capture screenshots, which are visually analyzed to read the displayed locations of your devices.

What is the best way to extract location details from the Find My app?

The best way to extract location details from Find My is automating the app with AppleScript, capturing screenshots of the UI, and performing visual analysis on the images.

How does AppleScript UI automation work with the Find My app?

AppleScript UI automation opens the Find My app and switches between the Devices and Items tabs, allowing screen captures to extract which device is shown and where it is located.

Are there limitations to locating Apple devices using macOS screen capture?

Locating Apple devices via macOS screen capture relies on visual analysis of screenshots, meaning it cannot fetch background location data and requires the Find My UI to be actively displayed.