findmy

Automates Apple device and AirTag location tracking via macOS Find My with AppleScript and optional Peekaboo UI automation.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/tangzheng202202/hermes-skills --skill findmy-tangzheng202202
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/tangzheng202202/hermes-skills/tree/main/99-integrations/apple/findmy
Command: npx skills add https://github.com/tangzheng202202/hermes-skills --skill findmy-tangzheng202202

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates locating Apple devices and AirTags on macOS when Find My lacks a CLI, using UI automation to open Find My, switch tabs, and read on-screen data via screenshots.

Core Features & Use Cases

  • AppleScript-based navigation: Opens Find My, switches to Devices and Items, and captures details from the UI.
  • Peekaboo UI automation (optional): Provides more reliable element interaction for location reads.
  • Use cases: Track AirTag patrol routes or monitor device locations over time with periodic checks.

Quick Start

Open Find My and begin tracking a device or AirTag using the provided workflow.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate tracking Apple devices and AirTags on macOS?

Automate tracking Apple devices and AirTags on macOS by using AppleScript-based UI automation to open the Find My app, switch tabs, and capture on-screen location data via screenshots.

Can I monitor AirTag movement over time using macOS UI automation?

Yes, you can monitor AirTag movement over time by running the UI automation workflow periodically to capture location reads and verify presence across your iCloud-connected devices.

Do I need screen-recording permission to use Find My automation on macOS?

Yes, macOS Find My automation requires screen-recording permission to capture on-screen data via screenshots, and optionally uses Peekaboo for more reliable UI element interaction.

Why does Find My lack a command line interface for tracking devices?

Find My lacks a CLI for tracking devices because Apple restricts programmatic access to location data, requiring AppleScript and UI automation to navigate the app and read on-screen details.

What is the best way to track AirTag patrol routes on macOS?

The best way to track AirTag patrol routes on macOS is using AppleScript-based automation to open Find My, switch to the Items tab, and capture location details through screenshots.

Does Peekaboo UI automation work with Find My on macOS?

Yes, Peekaboo UI automation works with Find My on macOS to provide more reliable element interaction for location reads, complementing the AppleScript-based navigation and screenshot capture.