skills.rest
i-bebsi
i-bebsiCOMMUNITY
Explore all skills by this author →
GitHub

findmy

Track Apple devices and AirTags via FindMy.app UI automation on macOS.

Updated Jun 17, 2026
Search Tags:#macos#ui automation#apple#location tracking#applescript#findmy#airtag
One-click install
npx skills add https://github.com/i-bebsi/hermes-agent --skill findmy-i-bebsi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/i-bebsi/hermes-agent/tree/main/hermes-config/skills/apple/findmy
Command: npx skills add https://github.com/i-bebsi/hermes-agent --skill findmy-i-bebsi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires peekaboo.

What problem does it solve? Apple provides no CLI or API for Find My, making it impossible to programmatically check device or AirTag locations. This Skill bridges that gap by automating the FindMy.app UI on macOS through AppleScript and screenshots, letting you query locations conversationally. ## Core Features & Use Cases - Device & AirTag Location Lookup: Open Find My, navigate between Devices and Items tabs, and read locations from screenshots using vision analysis. - UI Automation with Peekaboo: Optionally use the peekaboo tool for reliable element-level clicking and annotated UI captures. - Continuous Tracking: Periodically capture screenshots on a schedule to log an AirTag's movement over time, such as monitoring a pet's patrol route. - Use Case: Ask "where is my cat?" and the agent opens Find My, selects the cat's AirTag, captures the screen, and reports the current address and coordinates. ## Quick Start Ask the agent where your AirTag or Apple device is currently located and it will open Find My and read the location from the screen.

Frequently Asked Questions about findmy

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

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

Apple provides no CLI for Find My, so tracking requires UI automation. Use AppleScript to open FindMy.app, capture the window with screencapture, and analyze the screenshot with a vision tool to read the AirTag's location.

How to automate the Find My app with AppleScript?▼

Use osascript to activate FindMy and System Events to click toolbar buttons like Devices or Items. For more reliable element-level interaction, install peekaboo via brew and use its see, click, and image commands.

Does Find My have an API or CLI for location queries?▼

No, Apple does not expose any official API or command-line interface for Find My. The only options are UI automation with AppleScript and screenshot analysis, or unofficial private APIs that risk account issues.

Why is my AirTag location not updating in Find My?▼

AirTags only refresh their location while the Find My page is actively displayed in the foreground. Keep the app open and visible during tracking, and note that accuracy depends on nearby Apple devices in the Find My network.

What permissions are needed to screenshot Find My on macOS?▼

Your terminal needs Screen Recording permission, granted in System Settings under Privacy and Security. Without it, screencapture produces blank or incomplete images of the Find My window.

Related Skills

Explore More Personal & Entrepreneur Skills→
AlvaroBianoAlvaroBiano

findmy

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

Community
Intermediate
timominkustimominkus
9

Inbox Processor - Aggressive Organizer & Librarian

Classify Obsidian inbox files into PARA folders with renaming and YAML tagging.

Community
Advanced
VYRE-StudiosVYRE-Studios

findmy

Capture Find My app screenshots and extract device locations via image analysis.

Official
Intermediate
pmcdowallpmcdowall

findmy

Automate macOS Find My app to track Apple devices and AirTags.

Community
Intermediate