skills.rest
perasyudha
perasyudhaCOMMUNITY
Explore all skills by this author →
Website𝕏@Nyxora_AIGitHub

findmy

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

5|2|Updated May 26, 2026
Search Tags:#macos#ui automation#screenshot#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill findmy-perasyudha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/apple/findmy
Command: npx skills add https://github.com/perasyudha/Nyxora --skill findmy-perasyudha

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 through AppleScript and screen capture, letting you query locations conversationally. ## 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 annotated UI captures and precise element clicks for more reliable interaction. - Continuous AirTag Tracking: Periodically capture screenshots on a schedule to log an AirTag's movement over time, such as mapping a pet's patrol route. - Use Case: Ask "where is my cat?" and the Skill opens Find My, selects the cat's AirTag, captures the detail view, and reports the current address and coordinates. ## Quick Start Ask the agent where your AirTag or Apple device is, and it will open Find My, capture the screen, and report the 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 provides no CLI for Find My, so tracking requires UI automation. Use AppleScript to open FindMy.app, 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 interaction, install peekaboo via brew to capture annotated UI elements and click them by element ID.

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

No, Apple does not provide any official API or command-line interface for Find My. The only way to read locations programmatically on macOS is through UI automation with AppleScript, screenshots, and vision analysis.

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

AirTags only update their location while the Find My page is actively displayed in the foreground. If the app is minimized, updates stop, so keep FindMy in the foreground during continuous 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
AjayRajan05AjayRajan05
5

findmy

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

Community
Intermediate
xiaoquqixiaoquqi

findmy

Automate Find My on macOS to reveal Apple device and AirTag locations.

Community
Intermediate