skills.rest
specdog
specdogOFFICIAL
Explore all skills by this author →
WebsiteGitHub

findmy

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

1|Updated Jun 17, 2026
Search Tags:#macos#apple#screenshot#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/specdog/collar --skill findmy-specdog
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/specdog/collar/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/specdog/collar --skill findmy-specdog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

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 on macOS by driving the FindMy.app with AppleScript and reading locations from screenshots. ## Core Features & Use Cases - Device and AirTag Location Lookup: Open FindMy, switch between Devices and Items tabs, and capture the current location of any registered device or AirTag. - Vision-Based Reading: Use screenshot capture plus vision analysis to extract addresses and coordinates from the FindMy UI. - Longitudinal Tracking: Periodically capture AirTag positions (e.g., every 5 minutes) to compile patrol routes for pets or movement history for items. - Use Case: Ask where your cat wearing an AirTag has been, and the Skill opens FindMy, captures the Items tab over time, and compiles a location route. ## Quick Start Ask the agent to find the current location of your AirTag or Apple device using Find My on your 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, take 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, click, and image commands to interact with annotated UI elements.

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

No, Apple does not provide any official API or CLI for Find My. The only options are UI automation through AppleScript and screenshot analysis, or third-party tools like peekaboo that improve UI interaction reliability.

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

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

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

Your 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
DarkArty07DarkArty07
3

findmy

Automate macOS FindMy app to track Apple devices and AirTags.

Community
Intermediate
lidge-junlidge-jun
5

vision-click

Extract click coordinates from screenshots and click non-DOM elements.

Community
Advanced
benjaminshafiibenjaminshafii
10

home-assistant

Control Home Assistant devices via REST API with curl requests.

Community
Basic