findmy

Automate FindMy.app UI navigation to extract Apple device and AirTag locations from screenshots.

Updated May 5, 2026
One-click install
npx skills add https://github.com/Z43L/zeus-agent --skill findmy-z43l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Z43L/zeus-agent/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/Z43L/zeus-agent --skill findmy-z43l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly find and monitor Apple devices or AirTags when Apple provides no built-in command-line interface, by using macOS UI automation and visual reading to extract location details.

Core Features & Use Cases

  • AppleScript-based UI control: Opens FindMy.app and switches between Devices and Items (AirTags) to reach the relevant screen.
  • Screenshot-driven location capture: Uses screen capture plus vision analysis to read device/item names and displayed locations.
  • Optional Peekaboo automation: Improves reliability for clicking and capturing detail views when basic AppleScript interactions are flaky.
  • Use Case: Track an AirTag’s location over time (e.g., monitoring an item or pet’s movement) by periodically taking screenshots and analyzing the location from each one.

Quick Start

Ask Zeus to open the Find My app, capture the relevant Devices/Items view, and use vision to extract the displayed location for your requested device or AirTag.

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 using command line automation?

You can track AirTag location on macOS by automating FindMy.app with AppleScript to navigate UI elements, capturing screenshots, and using vision analysis to extract the displayed location details.

Can I automate Find My app to monitor Apple device locations without a CLI?

Yes, you can monitor Apple device locations by automating Find My app UI navigation with AppleScript, taking screen captures of the Devices or Items view, and applying vision analysis to read location text.

What are the requirements for tracking Apple devices via Find My app automation?

Tracking Apple devices requires macOS with Find My availability, iCloud signed in, AppleScript or optional Peekaboo-based UI automation, and screen recording permission to capture and analyze screenshots.

How do I record an AirTag location route over time on macOS?

To record an AirTag location route, you periodically take screenshots of the Find My app Items view and use vision-based analysis to extract and compile location updates from each captured snapshot.

What is the best way to retrieve iPhone location details when Find My UI automation is flaky?

When basic AppleScript interactions are flaky, using optional Peekaboo automation improves reliability for clicking UI elements and capturing detail views to retrieve iPhone location details.

Why does screenshot vision analysis fail to read Find My app location data?

Screenshot vision analysis fails if macOS screen recording permission is missing, iCloud is not signed in, or Find My app UI navigation does not reach the correct Devices or Items screen.