findmy

Automate Find My device and AirTag tracking via AppleScript and screen capture on macOS.

Updated Apr 23, 2026

Search Tags:#macos #apple #screen-capture #ui-automation #apple-script #findmy #airtag

Ready to run

npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill findmy-chris-chai-minjae

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill findmy-chris-chai-minjae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of a CLI for Find My by using AppleScript and screen capture to locate devices and AirTags on macOS.

Core Features & Use Cases

AppleScript automation to open Find My and read device locations.
Optional UI automation with Peekaboo for more reliable interactions.
Workflow to track AirTag locations over time, with periodic location checks.

Quick Start

Open Find My, switch to the Devices or Items tab as needed, and begin a tracking session following the workflow described in this skill's guidance.

Frequently Asked Questions about findmy

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

FAQPage Schema

How do I track AirTag locations on macOS when there is no command line interface for Find My?▼

Tracking AirTag locations on macOS without a CLI requires UI automation via AppleScript and screen capture to read the Find My app interface. This approach automates device location retrieval when command-line access is unavailable.

What macOS permissions do I need to automate Find My device tracking?▼

Automating Find My device tracking requires macOS with Find My configured in iCloud and screen recording permission granted. Peekaboo can optionally be added to increase UI automation reliability during device location retrieval.

Can I periodically check Apple device locations using AppleScript?▼

Yes, you can periodically check Apple device locations using AppleScript. The FindMy skill provides a workflow to track AirTag and device locations over time by automating periodic location checks via UI automation.

Does the FindMy skill work with the Find My Devices and Items tabs?▼

Yes, the FindMy skill works with both the Devices and Items tabs in the Find My app. You switch between these tabs during an AppleScript automation session to read locations for Apple devices and AirTags.

Why use Peekaboo for Find My UI automation instead of just AppleScript?▼

Peekaboo is used for Find My UI automation to achieve more reliable interactions than AppleScript alone. It enhances screen capture and interface manipulation to ensure consistent location data extraction from the Find My app.