findmy

Automate Apple's Find My app to track devices and AirTags via AppleScript and screen capture.

Updated Jun 17, 2026

Search Tags:#macos #apple #tracking #location #findmy #airtag

Ready to run

npx skills add https://github.com/cxnaive/hermes-agent-llbot --skill findmy-cxnaive

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/cxnaive/hermes-agent-llbot/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/cxnaive/hermes-agent-llbot --skill findmy-cxnaive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

What problem does it solve?

This skill solves the lack of a native command-line interface for Apple's Find My application, allowing users to programmatically locate their devices and AirTags.

Core Features & Use Cases

Device Tracking: Locate iPhones, iPads, Macs, and AirPods directly from your terminal.
AirTag Monitoring: Track the movement of items like keys or bags, including setting up automated patrol route logging.
Use Case: If you need to monitor the location of your pet wearing an AirTag over several hours, this skill can automate the process of capturing and logging location data at regular intervals.

Quick Start

Use the findmy skill to activate the Find My application and capture the current location of all registered devices.

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 terminal?▼

You can track Apple devices and AirTags from the macOS terminal by automating Find My application interface through AppleScript and screen capture analysis. This retrieves device locations and status programmatically without needing a native command-line tool.

Can I automate AirTag location monitoring for my pet over several hours?▼

Yes, you can automate AirTag location monitoring over several hours by capturing and logging location data at regular intervals. This allows continuous tracking of items like pet collars by periodically querying the Find My application.

Do I need special permissions to use AppleScript for Find My location retrieval?▼

Yes, you need system-level screen recording permissions to use AppleScript for Find My location retrieval. Optional peekaboo integration is also available to ensure reliable element interaction within the controlled UI automation environment.

What is the best way to log patrol routes using AirTags on macOS?▼

The best way to log patrol routes using AirTags on macOS is by automating the Find My application interface to capture location data at regular intervals. This programmatic method records movement patterns directly from your terminal.

Does this Find My automation method work without a native command-line interface?▼

Yes, this Find My automation method works without a native command-line interface by using AppleScript and screen capture analysis. It bridges the gap by facilitating location monitoring and device status retrieval through UI automation.

Why does Find My UI automation require screen recording permissions on macOS?▼

Find My UI automation requires screen recording permissions on macOS because the skill relies on screen capture analysis to read device locations and status. This system-level access allows the automation to interpret visual elements within the application.