findmy

Extract Apple device and AirTag locations from the Find My macOS UI via screenshots and vision analysis.

Updated May 16, 2026
One-click install
npx skills add https://github.com/jaredcroxton/hermes-mirror --skill findmy-jaredcroxton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/jaredcroxton/hermes-mirror/tree/main/agents/skills/apple/findmy
Command: npx skills add https://github.com/jaredcroxton/hermes-mirror --skill findmy-jaredcroxton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly determine where your Apple devices or AirTags are located, even though Find My provides no usable CLI or API for direct querying.

Core Features & Use Cases

  • AppleScript to open and navigate Find My: Activates Find My and switches between Devices and Items to reach the relevant screen.
  • Screen capture + vision extraction: Uses screenshots of the Find My UI and then reads the displayed device/item details (including locations when visible) with vision analysis.
  • Peekaboo UI automation for reliability: Optionally uses Peekaboo to click specific UI elements and capture more consistent detail views for repeated tracking.

Quick Start

Use the findmy skill to open Find My on macOS, capture the screen showing your target AirTag or device, and read its displayed location using vision analysis.

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 when there is no CLI or API?

To track AirTag location on macOS without a CLI, you can use AppleScript UI automation to open Find My, capture screenshots of the interface, and apply vision analysis to read the displayed location data.

Can I automate checking Apple device locations across different Find My tabs?

Yes, you can automate checking Apple device locations by using AppleScript to switch between Devices and Items tabs in Find My, capturing screenshots, and extracting location details through vision analysis.

What macOS permissions are required to extract Find My data via screen capture?

Extracting Find My data via screen capture requires macOS screen recording permissions to allow the screenshot vision analysis to read your Apple device and AirTag locations from the UI.

How does vision analysis read device details from the Find My UI?

Vision analysis reads device details by interpreting screenshots of the Find My macOS interface, extracting visible location information and device data without needing direct API access.

Is Peekaboo required for reliable location tracking of Apple devices?

Peekaboo is an optional component for reliable location tracking that clicks specific UI elements in Find My to capture more consistent detail views for repeated monitoring of Apple devices and AirTags.

What is the best way to periodically record AirTag location changes for monitoring?

The best way to periodically record AirTag location changes is by using AppleScript to navigate Find My, taking screenshots at intervals, and using vision analysis to log the extracted location data for ongoing monitoring.