skills.rest
Araara7
Araara7COMMUNITY
Explore all skills by this author →
GitHub

findmy

Track Apple devices and AirTags via FindMy.app UI automation on macOS.

1|Updated Jun 1, 2026
Search Tags:#macos#ui automation#location tracking#applescript#findmy#airtag#apple devices
One-click install
npx skills add https://github.com/Araara7/hermes-skills --skill findmy-araara7
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/Araara7/hermes-skills/tree/main/apple/findmy
Command: npx skills add https://github.com/Araara7/hermes-skills --skill findmy-araara7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Apple provides no CLI or API for Find My, so locating devices and AirTags from a terminal or agent workflow is impossible without UI automation. This Skill bridges that gap by driving the FindMy.app with AppleScript and screenshots. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy.app, switch between Devices and Items tabs, and read locations from screenshots using vision analysis. - Peekaboo UI Automation: Use the optional peekaboo tool for annotated UI captures and precise element clicks on macOS. - Continuous AirTag Tracking: Periodically capture the FindMy window to log an AirTag's movement over time, such as monitoring a pet's patrol route. - Use Case: Ask where your keys are, and the Skill opens Find My, captures the Items tab, and reports the AirTag's current address and coordinates. ## Quick Start Ask the assistant to find where your AirTag or Apple device is currently located using the Find My app.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track an AirTag location from the terminal on macOS?▼

Apple provides no CLI for Find My, so tracking requires UI automation. Open FindMy.app with AppleScript, capture the window with screencapture, and use vision analysis to read the AirTag's displayed location.

How to automate the Find My app with AppleScript?▼

Use osascript to activate the FindMy application and System Events to click toolbar buttons like Devices or Items. Combine this with screencapture to grab the window contents for analysis.

Does Find My have an API or command line interface?▼

No, Apple does not provide any CLI or public API for Find My. The only way to access device locations programmatically on macOS is through UI automation of the FindMy.app combined with screenshot analysis.

Why is my AirTag location not updating in Find My?▼

AirTags only update their location while the FindMy page is actively displayed, so keep the app in the foreground. Location accuracy also depends on nearby Apple devices in the Find My network relaying the tag's position.

What permissions are needed to screenshot the Find My app?▼

The terminal needs Screen Recording permission, granted in System Settings under Privacy and Security. Without it, screencapture cannot read the FindMy window contents.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
quiznatquiznat

findmy

Locate Apple devices and AirTags via FindMy.app using AppleScript and screen capture.

Community
Intermediate
borealBytesborealBytes
7

peekaboo

Automate macOS UI interactions via CLI to inspect, target, and drive elements.

Community
Intermediate
rickyanandarickyananda
1

findmy

Track Apple devices and AirTags via Find My app UI automation on macOS.

Community
Intermediate