findmy

Locate Apple devices and AirTags via Find My on macOS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locates Apple devices and AirTags when the user cannot query Find My via CLI, providing a quick way to retrieve their locations on macOS.

Core Features & Use Cases

  • AppleScript UI control: Opens Find My, switches tabs, and captures screenshots.
  • Peekaboo automation: Optional reliable UI interaction for devices and items.
  • Vision analysis integration: Sends captured images to vision_analyze to extract location data.
  • Use case: Ask for the location of a lost iPhone, AirTag on a pet, or any registered device.

Quick Start

Ask the skill to locate my iPhone using Find My on macOS.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I locate my AirTag or iPhone using macOS when Find My CLI is unavailable?

To locate an AirTag or iPhone on macOS, this Skill automates the Find My application using AppleScript or Peekaboo, captures screenshots, and analyzes them to extract your device's location. It handles the UI automation directly.

What macOS permissions are required to automate Find My for tracking my devices?

Automating Find My for device tracking requires macOS with Find My enabled and screen recording permission. These permissions allow AppleScript or Peekaboo to capture the necessary UI screenshots for analysis.

Can I use AppleScript to extract location data from the Find My app?

Yes, you can use AppleScript to control the Find My app, switch between device tabs, and capture screenshots. The images are then processed to extract the location data of registered Apple devices.

How does screenshot vision analysis retrieve the location of my Apple devices?

Screenshot vision analysis retrieves device locations by sending captured Find My app images to the vision_analyze component. This extracts the visual location data from the map interface.

What is the best way to check the whereabouts of a registered Mac or iPad on macOS?

The best way to check the whereabouts of a registered Mac or iPad is using this Skill. It opens Find My, switches to the appropriate tab, captures a screenshot, and processes it to locate your device.

Why does Find My automation on macOS require Peekaboo UI interaction?

Find My automation uses Peekaboo for reliable UI interaction when AppleScript alone is insufficient. Peekaboo ensures stable control over the app to capture accurate screenshots for location tracking.