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.