findmy

Automate Find My app via AppleScript and screen capture to locate Apple devices and AirTags.

150|25|Updated Apr 20, 2026

Search Tags:#macos #apple #ui-automation #apple-script #findmy #airtag #location-tracking

Ready to run

npx skills add https://github.com/Devsoul2026/Hermes-One-Click --skill findmy-devsoul2026

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Devsoul2026/Hermes-One-Click/tree/main/hermes-agent/skills/apple/findmy
Command: npx skills add https://github.com/Devsoul2026/Hermes-One-Click --skill findmy-devsoul2026

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locate Apple devices and AirTags via the FindMy.app on macOS. Since Apple doesn't provide a CLI for FindMy, this skill uses AppleScript to open the app and screen capture to read device locations.

Core Features & Use Cases

Automates opening Find My and switching between Devices and Items tabs to reveal locations.
Supports AppleScript UI automation and optional Peekaboo for more reliable interactions.
Workflow enables tracking or locating a device or AirTag and periodically capturing location data for review.

Quick Start

Open Find My app and run the guided automation to locate a selected device or AirTag.

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 on macOS from the command line?▼

AirTag location tracking on macOS is done by automating the Find My app with AppleScript and capturing the screen to read location data, since Apple provides no CLI for Find My.

Can I automate Find My app UI to retrieve Apple device locations?▼

Yes, Find My app UI automation is achievable using AppleScript to open the app and switch between Devices and Items tabs, capturing screen output to retrieve Apple device locations.

Do I need Peekaboo to automate Find My on macOS?▼

Peekaboo is an optional UI automation tool that improves reliability when automating Find My, but the skill also supports native AppleScript UI automation without it.

What permissions are required to automate Find My for location tracking?▼

Find My location tracking automation requires macOS with Find My signed in, plus Screen Recording permission for screenshots, to successfully capture device location data.

Can I periodically capture AirTag location data over time on macOS?▼

Yes, the skill supports AirTag patrol tracking over time by periodically capturing location data through Find My app automation, enabling continuous review of item locations.

Why does Find My automation fail to read device locations on macOS?▼

Find My automation fails when macOS lacks Screen Recording permission for screenshots or when Find My is not signed in, preventing the screen capture needed to read locations.