findmy

Tracks Apple devices and AirTags by automating the macOS via AppleScript and screen capture analysis.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/ghufronbagaskara/agent-im --skill findmy-ghufronbagaskara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/ghufronbagaskara/agent-im/tree/main/hermes-home/skills/apple/findmy
Command: npx skills add https://github.com/ghufronbagaskara/agent-im --skill findmy-ghufronbagaskara

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

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

Core Features & Use Cases

  • Device Tracking: Locate iPhones, iPads, Macs, and AirPods using automated UI interaction.
  • AirTag Monitoring: Track item movement and patrol routes for AirTags by keeping the Find My interface active.
  • Use Case: A user can ask the agent to check the current location of their keys or monitor the movement of a pet wearing an AirTag over a specific period.

Quick Start

Use the findmy skill to open the Find My application and report the current location of my AirTag.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track my AirTag location from the command line on macOS?

You can track AirTags from the command line by automating the macOS Find My application interface through AppleScript and screen capture analysis. This enables programmatic location monitoring for personal items without a native CLI.

Can I automate Find My to monitor iPhone or Mac hardware locations?

Yes, you can automate Find My to locate iPhones, iPads, Macs, and AirPods. The automation interacts with the native macOS application UI to report the current location of your Apple hardware across the ecosystem.

Do I need special permissions to automate Apple device tracking via macOS?

Yes, automating Apple device tracking requires macOS with iCloud integration and system-level screen recording permissions. These are necessary for the automation tool to capture and analyze the Find My interface.

How does automated AirTag monitoring work for tracking moving items?

Automated AirTag monitoring works by keeping the Find My application interface active to track item movement. It uses screen capture analysis to monitor the location of moving items like pets or keys over a specific period.

What are the limitations of using screen capture to track Apple devices?

The main limitation of using screen capture to track Apple devices is the strict dependency on the macOS graphical interface and screen recording permissions. It cannot run headlessly and may break if the Find My UI changes.