findmy

Track Apple device and AirTag locations via macOS UI automation and screenshot analysis.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/KarlinskyS/hermesSkills --skill findmy-karlinskys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/KarlinskyS/hermesSkills/tree/main/apple/findmy
Command: npx skills add https://github.com/KarlinskyS/hermesSkills --skill findmy-karlinskys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a repeatable way to determine the locations of Apple devices and AirTags on macOS when no official CLI or API exists, removing the need to manually open the Find My app and transcribe on-screen information.

Core Features & Use Cases

  • UI Automation & Capture: Use AppleScript or optional peekaboo automation to open Find My, navigate tabs, and capture the app window as an image.
  • Image-Based Location Extraction: Analyze screenshots with vision capabilities to extract device names, addresses, and coordinates.
  • Monitoring & Routes: Periodically capture the Find My view to track an AirTag over time and compile patrol routes for pets or items.
  • Use Case: Quickly answer "where is my device/keys/cat?" by taking a screenshot of the Find My detail view and extracting the shown location.

Quick Start

Open the Find My app on macOS, capture the app window screenshot (or use peekaboo if available), and ask the AI to analyze the image to report device names and their current locations including address and coordinates.

Frequently Asked Questions about findmy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track AirTag location on macOS automatically?

To track AirTag location on macOS automatically, this Skill uses AppleScript UI automation to open the Find My app, capture window screenshots, and extract device addresses and coordinates via image analysis. This removes the need to manually transcribe on-screen information.

Can I extract coordinates from the Find My app using UI automation?

Yes, you can extract coordinates from the Find My app using UI automation. The Skill automates app navigation and window capture, then applies image analysis to read device names, addresses, and coordinates directly from the screenshot.

Does locating Apple devices via screenshot analysis require screen recording permission?

Locating Apple devices via screenshot analysis requires macOS screen recording permission to capture the Find My app window. It also needs AppleScript or peekaboo for UI automation and an image analysis tool to extract text.

What is the best way to log AirTag routes over time on macOS?

The best way to log AirTag routes over time on macOS is by periodically capturing the Find My app view. This Skill repeatedly takes screenshots of the Find My window and extracts location data to compile patrol routes for pets or items.

Are there limitations to using AppleScript for Find My location tracking?

Limitations of using AppleScript for Find My location tracking include relying on macOS UI automation and screenshot analysis instead of an official CLI or API. It requires the Find My app to be signed in and depends on screen capture permissions.

How do I get current device locations from Find My without an API?

To get current device locations from Find My without an API, this Skill uses macOS UI automation to navigate the app and capture screenshots. It then analyzes the images to report device names, addresses, and coordinates.