Core Location CLI is a free, open-source command-line tool for macOS that taps directly into Apple's CoreLocation framework to stream your Mac's current geographic coordinates, altitude, and accuracy data to the terminal.
What is Core Location CLI?
Core Location CLI is a lightweight macOS utility — distributed as a single binary via Homebrew — that exposes Apple's CoreLocation framework to the command line, letting you query or continuously stream your machine's GPS/Wi-Fi/cell-triangulated position without writing a single line of Swift. Think of it as a UNIX-friendly window into the same location stack that powers Maps, Find My, and every location-aware app on the platform.
The project is maintained on GitHub by fulldecent and has attracted a steady community of contributors, which gives me confidence it tracks macOS API changes rather than bitrotting into irrelevance.
What does Core Location CLI do best?
It gives shell scripts, cron jobs, and automation workflows a reliable, native source of geographic truth — no third-party API key, no web round-trip, no privacy leak to an external service. I've used it to stamp photos with coordinates during fieldwork and to build location-triggered shell triggers (lock the screen when I leave my desk area). A quick corelocationcli invocation outputs latitude, longitude, altitude, and horizontal accuracy in a parseable format you can pipe directly into awk, jq, or any language's stdin.
- Continuous streaming mode — runs indefinitely, emitting a new fix each time CoreLocation updates; perfect for logging a device's path over time.
- Single-shot mode — exits after the first reliable fix; ideal for scripted lookups where you just need a coordinate stamp.
- Native accuracy — uses the same sensor-fusion CoreLocation uses everywhere on macOS: Wi-Fi BSSID triangulation, GPS (if hardware present), and nearby cell towers. On a MacBook in a city, I routinely get fixes within 20–50 metres.
- No cloud dependency — zero data leaves your machine beyond what Apple's own daemon sends. Contrast this with reverse-geocoding APIs that ship your location to a third-party server.
Is Core Location CLI free?
Yes — completely free to download, use, and modify. It's published under a permissive open-source licence on GitHub, so there's no freemium tier, no subscription, and no telemetry of any kind baked in. Install it in seconds with brew install corelocationcli.
Who should use Core Location CLI?
Anyone who lives in the terminal and occasionally needs to know where their Mac thinks it is. The sweet spot is developers, sysadmins, and automation enthusiasts — people who reach for grep before they reach for a GUI. I'd specifically recommend it for:
- Photographers and field researchers who want to geotag files from a shell script without opening a dedicated app.
- Home-lab tinkerers building location-aware triggers (e.g., HomeKit bridges, presence detection, geofenced cron jobs).
- iOS/macOS developers who want to sanity-check how CoreLocation behaves on real hardware before shipping a location-aware app.
- Privacy-conscious users who want to audit what their Mac reports as its location without granting a commercial app location permission.
It's emphatically not for someone who wants a pretty map or turn-by-turn navigation — for that, open Apple Maps.
What are the best Core Location CLI alternatives?
Alternatives depend on what you actually need. If you only want a one-time coordinate and don't mind an API call, ipapi.co or similar IP-geolocation services work from any machine with curl — but they're significantly less accurate (city-level at best) and leak your IP. If you're after a GUI experience, WhereAmI (a popular Mac App Store freebie) wraps CoreLocation in a minimal window, but gives you no scripting surface. For developers who want to mock location in the simulator, Xcode's built-in location simulation is the right tool. None of these matches Core Location CLI's combination of native accuracy, zero-dependency operation, and pipe-friendly output.
How do I trust Core Location CLI with location permissions?
macOS will prompt you to grant location access the first time you run it — exactly the same system dialog any other app triggers. You can review or revoke that permission at any time in System Settings → Privacy & Security → Location Services. The binary itself is open source, so the curious can audit every line before granting access.
