findmy

Automate FindMy.app via AppleScript to locate Apple devices and AirTags.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/ChimeraFoundationa/Agentx --skill findmy-chimerafoundationa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/ChimeraFoundationa/Agentx/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/ChimeraFoundationa/Agentx --skill findmy-chimerafoundationa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track Apple devices and AirTags via FindMy.app on macOS. Since Apple doesn't provide a CLI for FindMy, this skill uses AppleScript to open the app and screen capture to read device locations.

Core Features & Use Cases

  • AppleScript automation to open, navigate, and fetch device locations from FindMy.
  • Peekaboo UI automation (optional) for more reliable interactions.
  • Vision-based location extraction from screenshots to read coordinates.
  • Continuous tracking workflow to monitor AirTag locations over time.

Quick Start

Open Find My and run the automated workflow to locate your device and begin capture.

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 from a macOS command line?

You can track AirTags on macOS by using AppleScript to open the Find My app and capturing periodic screenshots, which vision tools then analyze to extract and log device coordinates.

How does screen capture extract device coordinates from Find My?

Screen capture extracts device coordinates by taking periodic screenshots of the Find My app interface, which vision-based tools then analyze to read and log the location data visually.

What macOS permissions are required to automate Find My location queries?

Automating Find My location queries requires macOS with Find My signed in, screen recording permission for capturing screenshots, and the ability to run AppleScript or optional Peekaboo UI automation.

Can I use Peekaboo UI automation to navigate the Find My app more reliably?

Yes, you can use optional Peekaboo UI automation alongside AppleScript to navigate the Find My app more reliably, ensuring consistent interactions when automating device location queries on macOS.

Why does my Find My automation not working on macOS fail to read locations?

Find My automation fails to read locations if macOS screen recording permission is missing, preventing screenshot capture, or if AppleScript and Peekaboo UI automation cannot navigate the app interface.