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.