findmy-locationTrack a shared contact's location via Apple Find My with street-level accuracy. Returns address, city, and context (home/work/out) by reading map landmarks. Supports configurable known locations and vision fallback for unknown places.
Install via ClawdBot CLI:
clawdbot install poiley/findmy-locationTrack shared contacts via Apple Find My with street-corner accuracy.
Your Mac must be signed into an iCloud account with Find My enabled:
brew install steipete/tap/peekabooGrant Accessibility and Screen Recording permissions when prompted (System Settings → Privacy & Security).
Hammerspoon provides reliable clicking that works across all apps. Without it, clicks may occasionally go to the wrong window.
brew install hammerspoon
open -a HammerspoonAdd to ~/.hammerspoon/init.lua:
local server = hs.httpserver.new(false, false)
server:setPort(9090)
server:setCallback(function(method, path, headers, body)
local data = body and hs.json.decode(body) or {}
if path == "/click" then
hs.eventtap.leftClick({x=data.x, y=data.y})
return hs.json.encode({status="clicked", x=data.x, y=data.y}), 200, {}
end
return hs.json.encode({error="not found"}), 404, {}
end)
server:start()Reload config (Hammerspoon menu → Reload Config), then create ~/.local/bin/hsclick:
#!/bin/bash
curl -s -X POST localhost:9090/click -d "{\"x\":$2,\"y\":$3}"
chmod +x ~/.local/bin/hsclickgit clone https://github.com/poiley/findmy-location.git
cd findmy-location
./install.shOr via ClawdHub:
clawdhub install findmy-locationCreate ~/.config/findmy-location/config.json:
{
"target": "John",
"known_locations": [
{
"name": "home",
"address": "123 Main St, City, ST",
"markers": ["landmark near home"]
},
{
"name": "work",
"address": "456 Office Blvd, City, ST",
"markers": ["landmark near work"]
}
]
}| Field | Description |
|-------|-------------|
| target | Contact name to track (optional - defaults to first shared contact) |
| known_locations | Array of places you want labeled with addresses |
| markers | Landmarks visible on the Find My map when at that location |
findmy-location # Human-readable output
findmy-location --json # JSON output123 Main St, City, ST (home) - Now{
"person": "contact@email.com",
"address": "Main St & 1st Ave",
"city": "Anytown",
"state": "WA",
"status": "Now",
"context": "out",
"screenshot": "/tmp/findmy-12345.png",
"needs_vision": false
}| Field | Description |
|-------|-------------|
| context | home, work, out, or unknown |
| needs_vision | If true, use AI vision on screenshot to read street names |
| screenshot | Path to captured map image |
| Issue | Solution |
|-------|----------|
| Clicks go to wrong window | Install Hammerspoon (see prerequisites) |
| "No person found" | Ensure location sharing is enabled in Find My |
| Always shows needs_vision: true | Add markers for frequently visited places |
| Permission errors | Grant peekaboo Accessibility + Screen Recording access |
MIT
Generated Mar 1, 2026
Parents use this skill to track their children's locations via shared Apple Find My contacts, ensuring they arrive safely at school or home. It provides real-time street-level updates and context like 'home' or 'out' for peace of mind without constant manual checks.
Caregivers monitor elderly family members with mobility issues by tracking their movements through shared locations. The skill alerts if they are at unfamiliar places, helping prevent wandering incidents and ensuring they are at expected locations like home or medical facilities.
Companies use this skill to track employees or contractors on-site for logistics or service calls, verifying their arrival at client addresses. It integrates with known work locations to automate check-ins and improve operational efficiency without dedicated GPS hardware.
Individuals track their own daily routines by sharing their location with themselves, using the skill to log time spent at home, work, or other places. This aids in time management analysis and habit formation based on location context.
Organizers use this skill to confirm attendees' presence at events like conferences or meetups by having them share locations temporarily. It checks if they are at the venue address, streamlining check-in processes and reducing manual verification efforts.
Offer a free basic version with limited tracking and ads, then charge a monthly fee for advanced features like unlimited contacts, historical data, and priority support. This model attracts casual users while monetizing power users in safety or business contexts.
License the skill to businesses in logistics, healthcare, or security for internal use, providing custom integrations and dedicated support. Charge based on the number of tracked employees or devices, with bulk discounts for enterprise clients.
Aggregate anonymized location data from users to offer insights on movement patterns, such as peak travel times or popular destinations. Sell these analytics reports to urban planners, marketers, or researchers for strategic decision-making.
💬 Integration Tip
Ensure all prerequisite tools like peekaboo and Hammerspoon are correctly installed and permissions are granted to avoid common issues like failed clicks or access errors.
Capture and automate macOS UI with the Peekaboo CLI.
Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Clawdbot to add a note, list notes, search notes, or manage note folders.
Speak responses aloud on macOS using the built-in `say` command when user input indicates Voice Wake/voice recognition (for example, messages starting with "User talked via voice recognition on <device>").
Homebrew package manager for macOS. Search, install, manage, and troubleshoot packages and casks.
Automate macOS desktop by capturing screenshots and executing precise mouse movements, clicks, and keyboard inputs via cliclick.