apple-find-my-local
by loganprit
Apple Apps & ServicesBrief
Control Apple Find My app via Peekaboo to locate people, devices, and items (AirTags)
Description
What This Skill Does
Controls the native macOS Find My app through UI automation via Peekaboo, allowing location lookups for people, devices, and AirTag items. Operates entirely locally with no third-party API calls or Apple ID credential exposure.
Uses native app automation instead of unofficial APIs, so no credentials leave the device and no Apple ID access is required.
When to Use It
- Checking where an AirTag-tracked item is on a map
- Playing a sound on a lost wallet or keys
- Seeing a family member's current location
- Listing all tracked devices in a household
- Locating a misplaced Mac or iPhone
Example Workflow
User asks: where are my keys?
- 1
Run fm-list.sh items to screenshot the Items tab
- 2
Identify the position of the keys entry in the sidebar
- 3
Run fm-locate.sh with that position number
- 4
Capture a screenshot showing the map location
- 5
Return the screenshot path with the map view
Screenshot of Find My showing the AirTag location on a map
Requirements
- OpenClaw.app installed and running with Screen Recording and Accessibility permissions granted
- Peekaboo CLI installed and configured
- PEEKABOO_BRIDGE_SOCKET environment variable set to the OpenClaw bridge socket path
- Find My.app open on macOS
Installation
clawhub install loganprit/apple-find-my-localRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.