findmy

Automate Apple device and AirTag location tracking in FindMy.app via AppleScript and screen capture.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track Apple devices and AirTags via the FindMy.app on macOS using AppleScript and screen capture to read live locations when a CLI is not available.

Core Features & Use Cases

  • AppleScript automation to open Find My and navigate to the Devices/Items view.
  • Screen capture based location reading to extract on-screen coordinates and statuses.
  • Optional enhancement using Peekaboo for more stable UI interactions if installed.
  • Use Case: quickly locate a missing device or monitor AirTag movement over time by periodic captures.

Quick Start

Open FindMy on macOS, ensure devices are visible, and capture a screenshot to read their locations.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate Find My app location tracking on macOS?

Find My app location tracking on macOS is automated using AppleScript to navigate the interface and screen capture to extract live device coordinates and statuses. This enables locating devices or tracking AirTags directly from your Mac.

Can I track AirTag movement over time using AppleScript?

Yes, AirTag movement can be tracked over time by running periodic AppleScript automations that open the Find My app and capture screenshots to read location changes at set intervals.

Do I need Peekaboo to automate Find My on macOS?

Peekaboo is not required but provides optional enhancement for more stable UI interactions during Find My automation. Standard AppleScript and screen capture can still locate devices without it.

Why use screen capture to read Apple device locations instead of a CLI?

Screen capture is used to read Apple device locations when a command line interface is not available. It extracts on-screen coordinates from the Find My app by capturing the visual interface data.

What permissions are required to automate the Find My app?

Automating the Find My app requires macOS and explicit permission to control the Find My app via AppleScript. You must also grant screen recording permissions for the screen capture based location reading to function.