findmy

Automate FindMy UI navigation to track Apple devices and AirTags.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

What problem does it solve?

This skill solves the lack of a native command-line interface for Apple's Find My service, allowing you to track your devices and items through automated UI interaction.

Core Features & Use Cases

  • Device Tracking: Quickly identify the location of iPhones, iPads, Macs, and AirPods.
  • AirTag Monitoring: Track personal items like keys or bags and monitor their movement over time.
  • Use Case: If you need to check if your laptop is still at the office or track the patrol route of a pet wearing an AirTag, this skill automates the necessary screen captures and visual analysis.

Quick Start

Use the findmy skill to open the Find My application and report the current location of my AirTag.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track my AirTag location from the command line on macOS?

Tracking Apple devices on macOS requires automating the Find My application through AppleScript-driven UI navigation and visual analysis of screen captures. It solves the lack of a native command-line interface by interacting directly with the app to report device locations.

Does tracking Apple devices via UI automation require special macOS permissions?

Yes, tracking Apple devices via UI automation requires macOS system permissions for screen recording. You must grant screen recording access so the skill can capture and visually analyze the Find My application interface to report locations.

Do I need to install peekaboo to monitor my AirTags on macOS?

Installing peekaboo is optional but recommended for enhanced automation when monitoring AirTags. It helps facilitate the AppleScript-driven UI navigation required to interact with the Find My application and track personal items.

What's the best way to check if my iPhone or Mac is still at the office?

The best way to check if your iPhone or Mac is at the office is to automate the Find My application on macOS. This process uses screen captures and visual analysis to quickly identify your Apple devices' current locations.

Can I monitor the movement route of a pet wearing an AirTag over time?

Yes, you can monitor the movement route of a pet wearing an AirTag by automating the Find My application. The skill captures screen updates over time to visually analyze and track the item's changing location.

Why is my FindMy automation not working on macOS?

FindMy automation fails on macOS if system permissions for screen recording are denied or the Find My application interface changes unexpectedly. Ensure screen recording access is granted and the macOS application interface remains stable for accurate visual analysis.