findmy

Track Apple devices and AirTags via FindMy.app using AppleScript and UI automation.

9|3|Updated May 18, 2026
One-click install
npx skills add https://github.com/jordanhubbard/mac --skill findmy-jordanhubbard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/jordanhubbard/mac/tree/main/src/mac/_hermes/skills/apple/findmy
Command: npx skills add https://github.com/jordanhubbard/mac --skill findmy-jordanhubbard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires osascript, screencapture, peekaboo, and includes scripts (resource) components.

What problem does it solve?

The skill resolves the issue of tracking Apple devices and AirTags by leveraging FindMy.app on macOS, providing a streamlined approach to device and item location.

Core Features & Use Cases

  • Device Tracking: Monitor the location of Apple devices and AirTags.
  • User Queries: Answer questions like "where is my [device/cat/keys/bag]?" or "Track AirTag locations."
  • Device Locations: Retrieve real-time locations of devices such as iPhones, iPads, Macs, and AirPods.
  • Pet or Item Tracking: Monitor the movement of pets or items over time with AirTags.

Quick Start

Run the 'findmy' skill to activate the Find My app and initiate the tracking process for a specified device.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track Apple devices and AirTags from the macOS command line?

You can track Apple devices and AirTags from the command line by using this skill to automate the Find My app via AppleScript and UI automation. It activates FindMy.app on macOS to retrieve real-time device locations based on your queries.

Can I use UI automation to find my iPhone or AirPods location on macOS?

Yes, you can use UI automation to find your iPhone or AirPods location on macOS. The skill leverages AppleScript to interact directly with the Find My app interface, retrieving the current location of your connected Apple devices.

Do I need Peekaboo to track AirTag locations with AppleScript?

Peekaboo is an optional dependency for enhanced UI automation when tracking AirTag locations with AppleScript. The core tracking functionality relies on osascript and screencapture, but Peekaboo improves automation reliability.

What is the best way to automate Find My app queries for tracking pets with AirTags?

The best way to automate Find My app queries for tracking pets with AirTags is using this AppleScript-based UI automation skill. It processes user-initiated location requests to monitor the movement of items or pets over time.

Why does Find My device tracking require UI automation instead of a CLI tool?

Find My device tracking requires UI automation because Apple does not provide a command-line interface for the Find My app. This skill uses AppleScript to control the graphical interface, enabling automated location queries for your devices.

Can I retrieve real-time locations for Macs and iPads without opening the Find My app manually?

Yes, you can retrieve real-time locations for Macs and iPads without opening the Find My app manually. This skill operates on user-initiated queries to programmatically launch and control FindMy.app via AppleScript UI automation.