findmy

Locate Apple devices and AirTags via Find My app automation on macOS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locating Apple devices and AirTags on macOS when there is no official CLI, by automating Find My and screen capture.

Core Features & Use Cases

  • AppleScript + Screenshot automation to open Find My, read device locations, and switch between Devices and Items views.
  • Optional Peekaboo-based UI automation for more reliable interactions when Find My UI changes.
  • Time-series location tracking to monitor movements of devices or AirTags over time.

Quick Start

Open FindMy on macOS and switch to the Devices tab, then begin periodically capturing screenshots and analyzing locations.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track Apple devices and AirTags on macOS from the command line?

You can track Apple devices and AirTags on macOS by automating the Find My app with AppleScript and capturing screenshots to extract location data. This bypasses the lack of an official CLI.

Can I monitor AirTag movement over time using macOS UI automation?

Yes, you can monitor AirTag movement over time by periodically capturing Find My app screenshots and analyzing them to build a time-series location tracking history.

Do I need screen recording permission to automate the Find My app?

Yes, screen recording permission is required to automate the Find My app. You also need the macOS Find My app configured with iCloud, and optionally Peekaboo for more reliable UI interactions.

What is the best way to switch between Devices and Items views in Find My?

The best way to switch between Devices and Items views is using AppleScript for UI automation, or leveraging Peekaboo for more reliable interactions when the Find My UI changes.

Why does my AppleScript automation fail to read Find My device locations?

AppleScript automation may fail to read Find My device locations if screen recording permissions are missing or the Find My UI has changed, requiring optional Peekaboo-based UI automation for reliable interactions.