findmy

Automate Find My on macOS to locate Apple devices and AirTags.

Updated May 20, 2026
One-click install
npx skills add https://github.com/SriRamkunamsetty/SITA2.0-HermesAgent --skill findmy-sriramkunamsetty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/SriRamkunamsetty/SITA2.0-HermesAgent/tree/main/hermes-agent/skills/apple/findmy
Command: npx skills add https://github.com/SriRamkunamsetty/SITA2.0-HermesAgent --skill findmy-sriramkunamsetty

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Find My offers no CLI; this skill provides a reproducible automation to locate owned devices and AirTags by programmatically opening Find My, performing screen captures, and analyzing UI text.

Core Features & Use Cases

  • AppleScript-based Find My automation to read device locations
  • Optional Peekaboo UI automation for reliable interaction
  • Timeline tracking by periodically capturing locations for patrol routes

Quick Start

Open Find My on macOS, grant screen recording permission, and run the automation to read locations.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track Apple devices using Find My on macOS without a CLI?

You can track Apple devices by programmatically opening Find My on macOS, performing screen captures, and analyzing UI text through AppleScript or Peekaboo UI automation. This provides a reproducible automation method for locating owned devices.

Can I automate AirTag location tracking on macOS?

Yes, you can automate AirTag location tracking on macOS by navigating the Items tab in the Find My app using AppleScript or Peekaboo UI automation. It captures and analyzes UI text to retrieve current locations.

What are the requirements for running Find My automation on macOS?

Find My automation requires macOS with Find My signed in, screen recording permission, and optionally Peekaboo for reliable UI interaction. No external APIs are needed to execute the tracking scripts.

How does timeline tracking for patrol routes work with Find My?

Timeline tracking for patrol routes works by periodically capturing Apple device locations over time. The automation extracts coordinates at intervals to build a historical route map for tracked devices and AirTags.

AppleScript vs Peekaboo UI automation for Find My: which is better?

AppleScript reads Find My device locations natively, while Peekaboo provides optional UI automation for more reliable interaction. Peekaboo is preferable for complex UI navigation across Devices and Items tabs where AppleScript may lack direct access.

Why is my Find My automation not capturing device locations?

Find My automation fails if macOS screen recording permission is not granted or the Find My app is not signed in. Ensure Peekaboo is installed if the script relies on UI automation instead of native AppleScript commands.