findmy

Automate FindMy UI interactions to locate Apple devices and AirTags on macOS.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/overviewlabs/WHOX --skill findmy-overviewlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/overviewlabs/WHOX/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/overviewlabs/WHOX --skill findmy-overviewlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple devices and AirTags don't offer a public CLI for FindMy, so this skill automates UI interactions to reveal device locations on macOS.

Core Features & Use Cases

  • AppleScript-based automation to open FindMy and read device locations.
  • Optional Peekaboo UI automation for more reliable interactions.
  • Workflow to track AirTag locations over time by periodically checking the location.
  • Privacy and permission notes: screen recording and FindMy access are required; respect privacy and ownership.

Quick Start

Open the Find My app on macOS and begin tracking your registered devices using the guidance above.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track AirTag location on macOS without a CLI?

Track AirTag location on macOS by automating FindMy UI interactions with AppleScript and screen capture, revealing device coordinates without needing a dedicated command line tool. Optional Peekaboo augmentation improves interaction reliability.

What permissions do I need to automate FindMy device tracking?

Automating FindMy device tracking requires macOS with FindMy access and explicit screen recording permissions. You must also respect privacy and ownership constraints when monitoring device movement over time.

Can I monitor Apple device movement over time using UI automation?

Yes, you can monitor Apple device movement over time by running AppleScript-based UI automation workflows that periodically open FindMy and capture screen coordinates to verify proximity and location changes.

Does FindMy automation work with Peekaboo for reliable screen capture?

FindMy automation works with optional Peekaboo integration to provide more reliable UI interactions and screen capture when reading device locations on macOS, ensuring consistent location data extraction.

Why use AppleScript to read FindMy locations instead of an API?

Use AppleScript to read FindMy locations because Apple devices and AirTags lack a public CLI or API for FindMy, making UI automation the only available interface to programmatically retrieve location data.

What are the limitations of tracking AirTags via macOS screen capture?

Limitations of tracking AirTags via macOS screen capture include dependency on screen recording permissions, potential UI interaction reliability issues without Peekaboo, and the requirement to respect privacy and ownership boundaries.