skills.rest
yakeworld
yakeworldCOMMUNITY
Explore all skills by this author →
GitHub

findmy

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

6|1|Updated May 11, 2026
Search Tags:#macos#ui automation#screenshot#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill findmy-yakeworld
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/apple/findmy
Command: npx skills add https://github.com/yakeworld/Synthos --skill findmy-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

What problem does it solve? Apple provides no CLI or API for the Find My app, so locating devices and AirTags programmatically on macOS is impossible through conventional means. This Skill bridges that gap by driving the FindMy app with AppleScript and screen capture, then reading locations with vision analysis. ## Core Features & Use Cases - UI Automation Location Reading: Opens FindMy via AppleScript, captures the window with screencapture, and extracts device locations using vision_analyze. - Peekaboo-Enhanced Interaction: Uses the optional peekaboo tool to annotate UI elements, click specific devices or AirTags, and capture detail views with addresses and coordinates. - Periodic AirTag Tracking: Runs timed capture loops to log an AirTag's movement over time, such as compiling a pet's patrol route. - Use Case: Ask where your backpack's AirTag is; the Skill opens FindMy, switches to the Items tab, clicks the AirTag, and returns the address shown in the detail view. ## Quick Start Use the findmy skill to locate my iPhone by opening the Find My app and reading its location from a screenshot.

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: activate the FindMy app with AppleScript, capture the window with screencapture, and read the location using vision_analyze. The peekaboo tool offers more reliable element clicking.

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. After a short sleep for loading, capture the window and analyze the screenshot to extract device names and locations.

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

No, Apple does not provide any CLI or public API for Find My. The only option on macOS is UI automation of the FindMy app combined with screen capture and vision-based reading of the displayed locations.

Why is my FindMy screenshot black when using screencapture?▼

A black screenshot means the terminal lacks Screen Recording permission. Grant it under System Settings, Privacy & Security, Screen Recording, then rerun the capture. Never report locations from a black screenshot.

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 backgrounded, updates stop, so keep FindMy focused on the item's page during periodic captures.

What are the limitations of FindMy UI automation?▼

Location accuracy depends on nearby Apple devices in the Find My network, AppleScript UI automation may break across macOS versions, and Screen Recording permission is mandatory. Only devices and items you own should be tracked.

Related Skills

Explore More Personal & Entrepreneur Skills→
LamseyahEliasLamseyahElias

findmy

Automate Find My UI to read on-screen Apple device locations.

Community
Intermediate
buda-aibuda-ai
25

rank-tracker

Track keyword ranking positions over time for domains and campaigns.

Official
Intermediate
mlamla123mlamla123

desktop-vision-pc

Capture Windows screenshots and simulate clicks and keystrokes via vision analysis.

Community
Intermediate
Simon-Copilot-StudioSimon-Copilot-Studio

findmy

Automate locating Apple devices and AirTags via Find My UI.

Community
Intermediate