skills.rest
azaanaliraza
azaanalirazaCOMMUNITY
Explore all skills by this author →
GitHub

findmy

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

Updated Apr 18, 2026
Search Tags:#macos#screen capture#location tracking#applescript#findmy#airtag#device tracking
One-click install
npx skills add https://github.com/azaanaliraza/operarius --skill findmy-azaanaliraza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/azaanaliraza/operarius/tree/main/src-tauri/bin/hermes/skills/apple/findmy
Command: npx skills add https://github.com/azaanaliraza/operarius --skill findmy-azaanaliraza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Apple provides no CLI or API for Find My, so there is no programmatic way to check the location of your devices or AirTags from the terminal. This Skill bridges that gap by automating the FindMy.app UI on macOS with AppleScript and reading locations from screenshots. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy.app, switch between Devices and Items tabs, and capture screenshots that are analyzed with vision to extract locations. - Peekaboo UI Automation: Optionally use the peekaboo tool for more reliable UI element clicking and annotated captures. - 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 your keys are, and the Skill opens Find My, navigates to the Items tab, screenshots the AirTag's position, and reports the address and coordinates. ## 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 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, 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 a short delay for loading, capture the window with screencapture -w and extract location details via vision analysis.

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. The only workaround on macOS is UI automation of the FindMy.app combined with screenshot capture and image analysis.

Why is my AirTag location not updating in Find My?▼

AirTags only refresh their location while the FindMy page is actively displayed, so keep the app in the foreground during tracking. Accuracy also depends on nearby Apple devices in the Find My network relaying the tag's position.

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

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

Automate the macOS Find My app to locate Apple devices and AirTags.

Community
Intermediate
devMoezdevMoez
1

findmy

Automate the Find My macOS UI to extract Apple device and AirTag locations.

Community
Intermediate
VYRE-StudiosVYRE-Studios

findmy

Capture Find My app screenshots and extract device locations via image analysis.

Official
Intermediate
unclehowellunclehowell

findmy

Automate the macOS Find My app to extract device locations from screenshots.

Community
Intermediate