findmy

Locate Apple devices and AirTags via Find My screenshots using AppleScript and vision.

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill findmy-jamesfincher
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/JamesFincher/gengar/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/JamesFincher/gengar --skill findmy-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill helps you quickly determine where your Apple devices or AirTags are when you need up-to-date location information but Apple doesn’t provide a usable CLI or API for Find My.

Core Features & Use Cases

  • AppleScript + screenshot workflow: Opens Find My on macOS and captures the screen to extract device/item locations via vision.
  • UI automation (Peekaboo): Improves reliability by interacting with Find My UI elements and capturing more targeted detail views.
  • AirTag monitoring over time: Repeatedly captures screenshots to build a location history while the Find My page remains open.

Use case: You ask where your AirTag (keys/bag/cat collar) is, then the Skill uses screenshots and vision to read the displayed location details.

Quick Start

Ask: “Track my AirTag location in Find My on macOS and report the location details shown on screen.”

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I get Apple AirTag location data on macOS without an API?▼

AirTag location tracking on macOS without an API is achieved by using AppleScript to open Find My and capturing screenshots. Vision-based analysis then extracts the displayed location details for reporting.

Can I automate Find My UI interactions to monitor an AirTag over time?▼

Automating Find My UI interactions for AirTag monitoring is possible by repeatedly capturing screenshots over time. This builds a location history while the app remains open on macOS.

Does Find My automation require Peekaboo for reliable element-level interaction?▼

Peekaboo is optionally leveraged to improve Find My UI automation reliability. It enables more targeted element-level interaction and captures detailed views within the app beyond standard screenshot analysis.

What is the best way to locate Apple devices using macOS automation?▼

The best way to locate Apple devices using macOS automation is combining AppleScript with vision screenshot analysis. This approach bypasses the lack of a Find My CLI or API to extract locations directly from the UI.

Why does my Find My location lookup fail without a CLI or API?▼

Find My location lookups fail without a CLI or API because Apple lacks programmatic access. This Skill overcomes the limitation by using AppleScript for UI navigation and vision analysis to read screen data.