skills.rest
vivekgoquest
vivekgoquestCOMMUNITY
Explore all skills by this author →
GitHub

findmy

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

Updated Aug 22, 2026
Search Tags:#macOS#UI automation#location tracking#applescript#FindMy#airtag#apple devices
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill findmy-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill findmy-vivekgoquest

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 FindMy.app with AppleScript and screenshots. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy.app, navigate Devices or 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 for more reliable interaction. - Continuous AirTag Tracking: Periodically capture the FindMy window to log an AirTag's movement over time, such as mapping a pet's patrol route. - Use Case: Ask where your keys are, and the agent opens Find My, selects the AirTag, captures the detail view, and reports the address and coordinates. ## Quick Start Ask the agent where your AirTag or Apple device is and it will open FindMy.app, capture the screen, and report the current location.

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

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

How to automate the Find My app with AppleScript?▼

Use osascript to activate FindMy and System Events to click toolbar buttons like Devices or Items. For more reliable interaction, install peekaboo via brew to annotate UI elements and click them by element ID.

Does Find My have an API or CLI for location tracking?▼

No, Apple provides neither an API nor a CLI for Find My. The only option on macOS is UI automation of FindMy.app combined with screenshot capture and vision-based reading of the displayed locations.

Why does my AirTag location stop updating during tracking?▼

AirTags only refresh their location while the FindMy page is actively displayed in the foreground. If the app is minimized or the item page is closed, updates stop, so keep FindMy visible during monitoring.

What permissions are needed to screenshot Find My on macOS?▼

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

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
jamsdoescodejamsdoescode

findmy

Track Apple devices and AirTags via FindMy.app using AppleScript and screenshots on macOS.

Community
Intermediate
VYRE-StudiosVYRE-Studios

findmy

Capture Find My app screenshots and extract device locations via image analysis.

Official
Intermediate
SignmanalSignmanal
1

findmy

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

Community
Intermediate