omarshahine/findmy-cli

findmy-cli is a command-line tool that reads location data from Apple's Find My app on macOS. Apple does not provide a public API for Find My locations, and the on-disk cache files are encrypted with keychain-bound keys, so this tool automates the Find My app's graphical interface instead. It captures a screenshot of the app window and uses Apple's built-in Vision framework to read the text through optical character recognition, or OCR. The tool is split into two parts. A small Swift binary called findmy-helper handles the macOS specific tasks, such as taking screenshots, listing windows, and simulating mouse clicks, because the relevant Apple APIs have no direct Go bindings. A Go command-line tool called findmy orchestrates everything, calling the helper and parsing results. Together they can list people and devices from the Find My sidebar, click on a specific entry to reveal a precise address, and output everything as plain text or JSON. Because the tool drives the GUI, the Mac display must be active and unlocked, since a sleeping display causes screenshots to return as solid black. For headless setups such as a Mac mini without a monitor, the README describes connecting an inexpensive dummy display adapter that tricks macOS into activating its window compositor, along with disabling display sleep. Required macOS permissions include Screen Recording and Accessibility, and the terminal process must be fully restarted after granting them. Beyond a standalone CLI, the project also packages the tool as a Homebrew formula, an NPM library, and a plugin for AI assistant systems built on Claude Code and OpenClaw. The project notes that GUI scraping may be outside Apple's terms of service and should be used at your own risk.