skills.rest
MLT-OSS
MLT-OSSOFFICIAL
Explore all skills by this author →
WebsiteGitHub

findmy

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

14|5|Updated Apr 9, 2026
Search Tags:#macos#apple#screen capture#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill findmy-mlt-oss
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill findmy-mlt-oss

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 is impossible without UI automation. This Skill bridges that gap by driving the FindMy.app 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 for vision-based location reading. - Peekaboo UI Automation: Use the optional peekaboo tool for annotated UI captures and precise element clicks on specific devices or AirTags. - Continuous AirTag Tracking: Periodically screenshot the FindMy window on a schedule to log an AirTag's movement over time, such as tracking a pet's patrol route. - Use Case: Ask where your keys are, and the agent opens Find My, clicks your AirTag, captures the detail view, and reports the address and coordinates shown on the map. ## Quick Start Ask the agent where your AirTag or Apple device is and it will open Find My, capture the screen, and report the current 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 terminal 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 the window with screencapture, and analyze the screenshot 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 interaction, install peekaboo via brew to capture annotated UI screenshots and click elements by ID.

Does Find My have an API or command line interface?▼

No, Apple does not provide any CLI or public API for Find My. The only way to access device and AirTag locations programmatically on macOS is through UI automation of the FindMy.app combined with screenshot analysis.

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

AirTags only update their location while the FindMy page is actively displayed in the foreground. If the app is minimized, updates stop. Keep FindMy in the foreground and use a scheduled capture loop for continuous tracking.

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

Screen Recording permission is required for the terminal to capture the FindMy window. Grant it in System Settings under Privacy and Security, then Screen Recording, before running screencapture or peekaboo commands.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
moltis-orgmoltis-org
2.8k

findmy

Automates Apple device and AirTag location tracking via FindMy app.

Official
Intermediate
harlanljonesharlanljones

findmy

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

Community
Intermediate
eddieluengeddielueng
1

findmy

Automate Find My app access on macOS to extract Apple device and AirTag locations from screenshots.

Community
Intermediate