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.