findmy

Automate FindMy UI interactions to locate Apple devices and AirTags on macOS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

FindMy.app provides no official CLI, making it challenging to locate Apple devices and AirTags from macOS. This Skill automates UI interactions via AppleScript and screen captures to extract current locations.

Core Features & Use Cases

  • AppleScript + Screenshot: Open FindMy and capture location data by reading the UI.
  • Peekaboo Optional Automation: Use Peekaboo for more reliable element interactions and improved location extraction.
  • Tracking Workflows: Monitor device movement over time or verify locations on demand.

Quick Start

Open FindMy, capture a screenshot of your devices, and analyze it 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 and AirTags from a macOS command line?

You can track Apple devices and AirTags from a macOS command line by automating FindMy UI interactions via AppleScript and capturing screen images to extract current location data.

Do I need Peekaboo to automate FindMy location extraction?

Peekaboo is an optional tool for automating FindMy location extraction, providing more reliable UI element interactions and improved location data extraction compared to standard AppleScript alone.

What macOS permissions are required to monitor AirTag locations via UI automation?

Monitoring AirTag locations via UI automation requires macOS with FindMy signed in and screen recording permission granted to allow the automation tool to capture and analyze interface elements.

Can I monitor Apple device movements over time using AppleScript?

Yes, you can monitor Apple device movements over time using AppleScript by repeatedly automating FindMy to capture screenshots and extract location data at desired intervals.

Why does FindMy UI automation fail to read locations on macOS?

FindMy UI automation fails to read locations on macOS if screen recording permission is missing or FindMy is not signed in, preventing AppleScript from capturing and analyzing the interface.

What is the best way to verify Apple device locations without an official FindMy CLI?

Without an official FindMy CLI, the best way to verify Apple device locations is using UI automation that drives FindMy via AppleScript and analyzes screen captures to extract location data.