findmy-location
by poiley
Apple Apps & ServicesBrief
Track a shared contact's location via Apple Find.
Description
What This Skill Does
Reads a shared contact's location from Apple Find My and returns a structured result with street address, city, and a context label (home, work, or out). It works by opening the Find My app, capturing the map, and matching visible landmarks against a user-defined list of known locations. A vision fallback flag is set when the location is unrecognized.
It exposes Find My location data as structured CLI output, making it scriptable for automations that the Find My app itself cannot trigger.
When to Use It
- Checking whether a family member has arrived home
- Knowing when a partner leaves the office
- Building location-aware automations triggered by a contact's position
- Logging a contact's location from a script or cron job
- Getting a quick terminal readout of someone's location without opening Find My
Example Workflow
User asks: "Where is John right now?"
- 1
Opens the Find My app and selects John from the shared contacts list
- 2
Captures a screenshot of the map and reads accessibility data
- 3
Matches visible map landmarks against configured known locations
- 4
Assigns a context label based on matched location markers
- 5
Returns the address, city, state, and context as structured output
456 Office Blvd, City, ST (work) - Now
Requirements
- iCloud account signed into macOS with Find My enabled
- Location sharing enabled by the tracked contact in Apple Find My
- peekaboo screen-reading CLI (non-standard brew tap: steipete/tap/peekaboo, requires Accessibility and Screen Recording permissions)
- Hammerspoon (optional, for reliable UI clicking across windows)
Installation
clawhub install poiley/findmy-locationRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.