findmy

Automate the macOS Find My app to locate Apple devices and AirTags.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/nelohenriq/hermes-agent-plus --skill findmy-nelohenriq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/nelohenriq/hermes-agent-plus/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/nelohenriq/hermes-agent-plus --skill findmy-nelohenriq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track Apple devices and AirTags locations on macOS by automating Find My with AppleScript and screen capture, circumventing the lack of a CLI.

Core Features & Use Cases

  • AppleScript automation to open Find My, switch to the Devices and Items tabs, and navigate the UI.
  • Screen capture and vision analysis to read device locations from the UI.
  • Optional: Peekaboo UI automation for more reliable interactions.
  • Workflow to monitor AirTag locations over time by periodically capturing the UI and extracting coordinates.
  • Clear limitations and rules to protect privacy and stability.

Quick Start

Open Find My, use AppleScript or Peekaboo to capture a device's location, and run vision_analyze on the screenshot to extract coordinates.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track AirTag locations on macOS when there is no command line interface?

Track AirTag locations on macOS by automating the Find My app with AppleScript UI automation. This bypasses the missing CLI by navigating the interface, capturing screenshots, and using vision analysis to extract coordinates.

What permissions do I need to automate Find My with AppleScript?

Automating Find My with AppleScript requires screen recording permission to capture the UI. Optional Peekaboo UI automation can provide more reliable interactions, while vision_analyze reads the captured screenshots to extract location data.

How can I monitor Apple device movement over time across sessions?

Monitor Apple device movement over time by periodically capturing the Find My UI and extracting coordinates. The workflow automates AirTag location tracking across sessions, allowing you to patrol and log movement data continuously.

Does Find My automation work with vision analysis to read device locations?

Find My automation works with vision analysis by capturing screenshots of the UI and running vision_analyze to read device locations. This combination extracts coordinates directly from the visual interface since no direct data API exists.

What are the limitations of automating Find My on macOS?

Limitations of automating Find My on macOS include UI stability issues during automation, privacy protection rules, and reliance on screen capture permissions. AppleScript interactions can be fragile, requiring careful navigation of the Devices and Items tabs.

Can I use Peekaboo for more reliable Find My UI automation?

Peekaboo can be used for more reliable Find My UI automation on macOS. It enhances the AppleScript workflow by providing more dependable interactions when opening the app, switching tabs, and navigating the interface to capture device locations.