skills.rest
TylerSimons1127
TylerSimons1127COMMUNITY
Explore all skills by this author →
GitHub

findmy

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Apple provides no CLI or API for Find My, making it impossible to programmatically check device or AirTag locations. This Skill bridges that gap by automating the FindMy.app UI on macOS with AppleScript and screenshots, letting you query locations through an AI agent. ## Core Features & Use Cases - Device & 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 reliable element-level clicking and annotated UI captures. - Periodic Tracking: Capture AirTag locations on a schedule (e.g., every 5 minutes) to compile movement routes, such as monitoring a pet's patrol path. - Use Case: Ask "where are my keys?" and the agent opens Find My, screenshots the Items tab, and reports the AirTag's current address and coordinates. ## Quick Start Ask the agent where your AirTag or Apple device is currently located using Find My on your Mac.

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 provides no CLI for Find My, so tracking requires UI automation: open FindMy.app with AppleScript, capture the window with screencapture, and analyze the screenshot with a vision tool to read the AirTag's location.

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 element-level interaction, install peekaboo via brew and use its see, click, and image commands.

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

No, Apple does not expose any official API or command-line interface for Find My. All programmatic access must go through UI automation of the FindMy.app combined with screenshot analysis.

Why does my AirTag location stop updating in Find My?▼

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

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

Screen Recording permission must be granted to your terminal in System Settings under Privacy. 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
azaanalirazaazaanaliraza

findmy

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

Community
Intermediate
MLT-OSSMLT-OSS
14

findmy

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

Official
Intermediate
AevonixAevonix

findmy

Automate Apple device and AirTag location capture via FindMy and AppleScript.

Official
Advanced