Agent skill · software engineering · nousresearch
findmy
Track Apple devices/AirTags via FindMy.app on macOS.
Why this skill is useful
Provides executable AppleScript commands and UI automation patterns for tracking devices via FindMy, which are not commonly known.
What it needs
Requires peekaboo installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
Find My (Apple) Track Apple devices and AirTags via the FindMy.app on macOS. Since Apple doesn't provide a CLI for FindMy, this skill uses AppleScript to open the app and screen capture to read device locations. Prerequisites macOS with Find My app and iCloud signed in Devices/AirTags already registered in Find My Screen Recording permission for terminal (System Settings → Privacy → Screen Recording) Optional but recommended: Install peekaboo for better UI automation: brew install steipete/tap/peekaboo When to Use User asks "where is my [device/cat/keys/bag]?" Tracking AirTag locations Checking device locations (iPhone, iPad, Mac, AirPods) Monitoring pet or item movement over time (AirTag patrol routes) Method 1: AppleScript + Screenshot (Basic) Open FindMy and Navigate Then use visionanalyze to read the screenshot: Switch Between Tabs Method 2: Peekaboo UI Automation (Recommended) If peekaboo is installed, use it for more reliable UI interaction: Then analyze with vision: Workflow: Track AirTag Location Over Time For monitoring an AirTag (e.g., tracking a cat's patrol route): Analyze each screenshot with vision to extract coordinates, then compile a route. Limitations FindMy has no CLI or API — must use UI automation AirTags only update location while the FindMy page is actively displayed Location accuracy depends on nearby Apple devices in the FindMy network Screen Recording permission required for screenshots AppleScript UI automation may break across macOS versions Rules 1. Keep FindMy app in the foreground when tracking AirTags (updates stop when minimized) 2. Use visionanalyze to read screenshot content — don't try to parse pixels 3. For ongoing tracking, use a cronjob to periodically capture and log locations 4. Respect privacy — only track devices/items the user owns
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/findmy