findmy

Automate the macOS Find My app to locate Apple devices and AirTags.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

FindMy lacks a CLI; this skill provides a scripted way to read device and AirTag locations from macOS Find My using AppleScript, screen capture, and optional UI automation.

Core Features & Use Cases

  • AppleScript + Screenshot method to read locations
  • Peekaboo UI automation (optional) for more reliable interactions
  • Workflow for tracking AirTags over time through periodic location captures

Quick Start

Open FindMy, switch to the Devices tab, and begin capturing and analyzing locations with vision_analyze.

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 automatically on macOS?

Automating AirTag location tracking on macOS involves using AppleScript and screen capture to interface with the Find My app. This skill periodically captures UI data to extract current device locations and patrol routes for AirTags.

Can I get Apple device locations from Find My using a script?

Yes, you can script Apple device location extraction by automating the macOS Find My app. The skill uses AppleScript to interact with the UI and analyzes screen captures to read device coordinates.

Do I need Peekaboo to automate Find My on macOS?

Peekaboo is an optional dependency for automating Find My on macOS, providing more reliable UI interactions. The core location tracking functionality relies on AppleScript and screen capture with vision analysis.

What permissions are required to read Find My device locations?

Reading Find My device locations requires an active iCloud sign-in, the macOS Find My app installed, and screen recording permission to capture and analyze UI data. Optional Peekaboo integration enhances UI automation reliability.

How does screenshot-based UI automation work for location tracking?

Screenshot-based UI automation for location tracking works by capturing the Find My app interface and using vision_analyze to extract location data. This method bypasses the lack of a FindMy CLI by reading screen pixels directly.

Can I monitor AirTag patrol routes over time with macOS automation?

You can monitor AirTag patrol routes over time by configuring periodic location captures. The skill automates the macOS Find My app to continuously track and record AirTag movements at scheduled intervals.