{"repo":"omarshahine/findmy-cli","free":true,"listed":false,"github":"https://github.com/omarshahine/findmy-cli","clone":"git clone https://github.com/omarshahine/findmy-cli.git","description":"Query Find My friend locations on macOS via UI automation, screenshots, and Vision OCR — structured output for CLIs and agents.","language":"Go","stars":51,"topics":["ai-agents","automation","cli","find-my","macos","vision-ocr"],"license":"MIT","category":"cli-tools","readme_excerpt":"findmy-cli Read your Find My people, device, and item locations from the macOS FindMy.app via UI scraping. Apple does not expose a public API for Find My locations and the on-disk caches are encrypted with keychain-bound keys, so this tool drives the GUI: it activates FindMy.app, switches to the People, Devices, or Items tab, screenshots the window, and runs Vision OCR on the result. Privacy & consent. This is read-only and consent-bounded. It can only see the people who have already opted in to share their location with this Mac's Apple ID in Apple's Find My, plus your own devices and items. It returns coarse location only (city/state, staleness, distance), bypasses no Apple access control, and initiates no network traffic — everything stays on-device. Use it to locate consenting friends and family, not to monitor or track anyone without their knowledge and consent. Why a Go CLI plus a Swift helper The macOS APIs we need (Vision, CoreGraphics window list, CGEvent click) have no Go binding. We bundle a tiny Swift binary findmy-helper that exposes them as JSON-emitting subcommands, and a Go CLI findmy that orchestrates. Install Pick the channel that matches how you'll use it: Goal Channel Command --- --- --- Use findmy CLI from terminal Homebrew brew install omarshahine/tap/findmy-cli Use as OpenClaw plugin (chat tools) ClawHub clawhub install findmy-cli Use as Claude Code plugin OpenClaw openclaw plugins install --link /GitHub/findmy-cli Use as a Node library NPM npm install ","default_branch":null,"files":null,"tree":[],"storefront":"/r/omarshahine","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/omarshahine/findmy-cli/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}