skills.rest
josoroma
josoromaCOMMUNITY
Explore all skills by this author →
GitHub

findmy

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

6|Updated Jul 12, 2026
Search Tags:#macos#ui automation#apple#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/josoroma/AppLoop --skill findmy-josoroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/josoroma/AppLoop/tree/main/.hermes/skills/apple/findmy
Command: npx skills add https://github.com/josoroma/AppLoop --skill findmy-josoroma

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 requires manual app interaction. This Skill bridges that gap using AppleScript and screen capture to read device locations programmatically. ## Core Features & Use Cases - UI Automation of FindMy.app: Opens Find My, switches between Devices and Items tabs, and clicks specific entries via AppleScript or the optional peekaboo tool. - Vision-Based Location Reading: Captures screenshots of the Find My window and uses vision analysis to extract device names, addresses, and coordinates. - AirTag Tracking Over Time: Periodically captures AirTag positions to compile movement routes, such as monitoring a pet's patrol path. - Use Case: Ask where your keys are, and the Skill opens Find My, selects the AirTag, screenshots the detail view, and reports the current address. ## Quick Start Ask the agent to find where your AirTag or Apple device is currently located using Find My on this 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. Use AppleScript to open FindMy.app, navigate to the Items tab, capture a screenshot with screencapture, and analyze the image with a vision tool to read the 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 targeting, install peekaboo via brew and use its see and click commands with annotated UI captures.

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 during tracking?▼

AirTags only update their location while the Find My page is actively displayed in the foreground. If the app is minimized or the tab is switched, updates pause, so keep FindMy visible during monitoring sessions.

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
uk-agentsuk-agents
9

leave-tracker

Identify open statutory leaves with upcoming HR or legal decision deadlines.

Official
Intermediate
trohitgtrohitg
356

geocoding-skill

Convert addresses to coordinates and coordinates to addresses via Google Maps Geocoding API.

Community
Intermediate
Chris-Chai-MinjaeChris-Chai-Minjae

findmy

Automate Find My device and AirTag tracking via AppleScript and screen capture on macOS.

Community
Intermediate