findmy

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

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill findmy-jakubbartnik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/jakubbartnik/honey-barrel-finale/tree/main/honey-barrel-finale/workspace/hermes/skills/apple/findmy
Command: npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill findmy-jakubbartnik

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 automation workflow is impossible without UI automation. This Skill bridges that gap by driving the FindMy.app with AppleScript and reading locations from screenshots. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy, switch between Devices and Items tabs, and capture the current location of any registered device or AirTag. - UI Automation with Peekaboo: Optionally use the peekaboo tool for more reliable element-level clicking and annotated UI captures. - Continuous AirTag Tracking: Periodically screenshot 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 Skill opens Find My, captures the Items tab, and uses vision analysis to report the AirTag's current address. ## 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. Use AppleScript to open FindMy.app, navigate to the Items tab, take a screenshot with screencapture, and analyze the image with a vision tool to read the AirTag's 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. After the UI loads, capture the window with screencapture and extract location details using vision 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 and AirTag locations programmatically on macOS is through UI automation of the FindMy.app combined with screenshot analysis.

Why does my AirTag location stop updating during tracking?▼

AirTags only update their location while the FindMy page is actively displayed in the foreground. If the app is minimized or the page is closed, updates stop, so keep FindMy visible during continuous tracking sessions.

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 for vision analysis.