findmy

Track Apple devices and AirTags by reading on-screen FindMy locations via AppleScript.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/travelinman1013/leroys-agent --skill findmy-travelinman1013
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/travelinman1013/leroys-agent/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/travelinman1013/leroys-agent --skill findmy-travelinman1013

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tracking Apple devices and AirTags via the FindMy app on macOS is not directly accessible through a CLI or API; this skill provides a scripted way to read on-screen locations using AppleScript and optional UI automation with screen captures.

Core Features & Use Cases

  • Read on-screen device locations via FindMy using AppleScript and optional UI automation with tools like Peekaboo.
  • Track AirTag locations and monitor device movements across the Devices and Items tabs.
  • Useful for personal device recovery, pet tracking, or inventory monitoring when FindMy data is needed in automation.

Quick Start

Open FindMy and read the current device locations using vision_analyze.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track AirTag locations on macOS using automation?▼

Yes, you can track AirTag locations on macOS by utilizing AppleScript automation and screenshot-based analysis to read on-screen data directly from the FindMy app. This skill extracts location information from the Items tab without needing a dedicated CLI or API.

Can I automate reading Apple device locations from the FindMy app?▼

Yes, automating reading Apple device locations is possible by leveraging AppleScript and optional UI automation with screen captures. It reads on-screen positions from the FindMy Devices tab to verify device locations.

Do I need screen recording permission to track Apple devices on macOS?▼

Yes, screen recording permission on macOS is required to track Apple devices using this method. The automation requires screen captures to analyze the FindMy app interface and extract location data accurately.

What is the best way to monitor AirTag movement for inventory tracking?▼

The best way to monitor AirTag movement for inventory tracking is using AppleScript automation with screenshot-based analysis to patrol the FindMy Items tab. This approach captures on-screen location changes over time.

Does FindMy location tracking work with Peekaboo integration on macOS?▼

Yes, FindMy location tracking works with optional Peekaboo integration on macOS to enhance UI automation. Combined with AppleScript, it reads on-screen device and AirTag locations from the FindMy app.

Why does my FindMy automation fail to extract device locations?▼

Your FindMy automation may fail to extract device locations if macOS screen recording permissions are missing or FindMy is not signed in. The tool relies on analyzing on-screen screen captures to function correctly.