findmy

Track Apple device and AirTag locations via FindMy.app UI automation.

247|22|Updated Dec 11, 2024
One-click install
npx skills add https://github.com/graniet/kheish --skill findmy-graniet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/graniet/kheish/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/graniet/kheish --skill findmy-graniet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple does not offer a native CLI or public API for the FindMy.app on macOS, forcing users to manually navigate the interface to locate registered devices and AirTags, which is time-consuming and impossible to automate for recurring checks.

Core Features & Use Cases

  • No-CLI FindMy Access: Interact with the FindMy.app interface via AppleScript and screen capture to retrieve device and AirTag locations without official command-line tooling.
  • Dual Automation Methods: Choose between a basic AppleScript + screenshot workflow or the more reliable Peekaboo UI automation tool for consistent, repeatable results.
  • Long-Term Item Monitoring: Track AirTag-equipped items like pets, keys, or bags over time to log movement patterns and patrol routes for ongoing awareness.

Quick Start

Use the findmy skill to check the current location of your registered AirTag or Apple device by opening FindMy.app and analyzing its screen output with visual recognition.

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 on macOS without a native FindMy CLI?

Track Apple devices and AirTags on macOS by using AppleScript UI automation and screen capture to interact with the FindMy.app interface and extract location data. This skill automates the process without requiring official command-line tooling.

Can I automate retrieving current location data for my iCloud-linked devices?

Yes, retrieving current location data for iCloud-linked devices is possible. The skill leverages AppleScript to open FindMy.app and uses visual analysis of screen captures to locate registered devices automatically.

What is the best way to monitor AirTag-equipped items like pets over time?

Monitor AirTag-equipped items over time by automating recurring location checks. This skill logs movement patterns and patrol routes for pets or personal belongings by repeatedly extracting location data from the FindMy.app interface.

Does the FindMy tracking automation require Peekaboo to function?

Peekaboo is not strictly required to function. You can choose between a basic AppleScript and screenshot workflow or the more reliable Peekaboo UI automation tool for consistent, repeatable results when tracking devices.

Why does this approach use screen capture instead of a public FindMy API?

This approach uses screen capture because Apple does not offer a native CLI or public API for FindMy.app on macOS. Visual analysis of screen output bypasses this limitation to extract location information.

What are the limitations of using AppleScript for FindMy UI automation?

Limitations of using AppleScript for FindMy UI automation include potential inconsistency during interface changes. The basic AppleScript and screenshot workflow may be less reliable than Peekaboo for repeatable visual analysis results.