findmy

Track Apple devices and AirTags on macOS via FindMy.app UI automation.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill findmy-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Signmanal/VIGIL/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/Signmanal/VIGIL --skill findmy-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple does not provide a native CLI or public API for the FindMy.app on macOS, making it tedious to manually check the location of registered Apple devices and AirTags through the graphical interface.

Core Features & Use Cases

  • FindMy.app UI Automation: Interact with the FindMy.app interface via AppleScript and screen capture to retrieve device and AirTag locations without a native CLI.
  • Cross-Device Tracking: Locate iPhones, iPads, Macs, AirPods, and registered AirTags, with support for long-term movement monitoring for items like pet collars or keys.
  • Reliable Automation Option: Integrates with the optional peekaboo tool for more stable UI interaction, reducing breakage from macOS version updates.

Quick Start

Ask the findmy skill to show you the current location of the AirTag attached to your laptop bag.

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 and AirTag locations from macOS without a native CLI?

To track AirTag movement over time on macOS, this Skill automates the FindMy.app interface using AppleScript and screen capture to extract location data at regular intervals. It requires an active iCloud sign-in and the FindMy.app installed.

Can I automate FindMy.app UI interaction without it breaking on macOS updates?

Yes, you can stabilize FindMy.app UI automation against macOS version updates by integrating the optional peekaboo tool for more stable interaction. This approach reduces breakage from macOS version updates compared to standard AppleScript alone.

Do I need an active iCloud sign-in to locate my Apple devices via UI automation?

Yes, an active iCloud sign-in is required to locate Apple devices via UI automation. The Skill operates by interacting with the FindMy.app on macOS, which inherently requires authenticated access to your iCloud account to retrieve location data.

What Apple devices can I locate by automating the FindMy.app interface?

By automating the FindMy.app interface, you can locate iPhones, iPads, Macs, AirPods, and registered AirTags. The Skill supports cross-device tracking for personal hardware and long-term movement monitoring for attached items.

Does Apple provide a public API for retrieving AirTag location data on macOS?

No, Apple does not provide a public API for retrieving AirTag location data on macOS. This Skill bypasses that limitation by applying AppleScript and screen capture to extract real-time location information directly from the FindMy.app interface.