Skill metadata
Reference: full SKILL.md
The following is the complete skill definition that Mibyan loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
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
peekaboofor 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
vision_analyze to read the screenshot:
Switch Between Tabs
Method 2: Peekaboo UI Automation (Recommended)
Ifpeekaboo is installed, use it for more reliable UI interaction:
Workflow: Track AirTag Location Over Time
For monitoring an AirTag (e.g., tracking a cat’s patrol 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
- Keep FindMy app in the foreground when tracking AirTags (updates stop when minimized)
- Use
vision_analyzeto read screenshot content — don’t try to parse pixels - For ongoing tracking, use a cronjob to periodically capture and log locations
- Respect privacy — only track devices/items the user owns

