findmy

Track Apple devices and AirTags via Find My on macOS using AppleScript and screen captures.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill findmy-john-data-chen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/john-data-chen/hermes-agent-backup/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill findmy-john-data-chen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track Apple devices and AirTags via the FindMy.app on macOS. Since Apple doesn't provide a CLI for FindMy, this skill uses AppleScript to open the app and screen capture to read device locations.

Core Features & Use Cases

  • Automates opening Find My, switching between Devices and Items, and capturing on-screen locations for devices and AirTags.
  • Optional but recommended: use Peekaboo for more reliable UI automation and element targeting.
  • Use Case: Track an AirTag's location over time by periodically capturing screenshots and analyzing the results.

Quick Start

Open Find My and verify that the desired devices are visible, then start the location-tracking workflow.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track AirTag location on macOS from the command line?

Yes, you can automate Find My device tracking on macOS using AppleScript for UI automation. The skill launches the app, switches between the Devices and Items tabs, and captures screenshots to read the current device locations.

How does screen capture UI automation read Find My locations?

Screen capture UI automation reads Find My locations by taking screenshots of the app's detail view. The skill analyzes these captured images to extract and validate the location data displayed for your Apple devices and AirTags.

Do I need Peekaboo for macOS Find My UI automation?

Peekaboo is optional but recommended for macOS Find My UI automation. Integrating Peekaboo provides more reliable element targeting and interaction when automating the Find My app interface compared to using standard AppleScript alone.

Can I monitor AirTag movement over time using macOS automation?

You can monitor AirTag movement over time by periodically capturing screenshots and analyzing the results. This macOS automation workflow repeatedly queries the Find My app to log the changing location data of your tracked items.

What are the limitations of using AppleScript to track Find My devices?

A limitation of using AppleScript to track Find My devices is its reliance on screen capture and UI automation. This approach requires the Find My app window to be visible and may break if the application's interface layout changes during an update.