SkillJavaScriptv1.0.2
apple-find-my-local
Control Apple Find My app via Peekaboo to locate people, devices, and items (AirTags)
0 downloads
loganprit
Updated Feb 16, 2026Find My
Control the native Find My app via Peekaboo. No sketchy APIs or credential sharing.
Run scripts from: cd {skillDir}
Requirements
| Requirement | Details |
|---|---|
| OS | macOS only |
| Apps | Find My.app (must be open), OpenClaw.app (provides Peekaboo bridge) |
| Permissions | OpenClaw.app needs Screen Recording + Accessibility permissions |
| Peekaboo | CLI must be installed and configured |
Privacy & Security
What this skill accesses:
- Location data for people, devices, and items in your Find My app
- Screenshots of the Find My window (stored locally in
/tmp/)
What this skill does NOT do:
- No network requests to third-party services
- No credential storage or Apple ID access
- No data exfiltration — all operations are local UI automation
Data scope: The skill can see/interact with anything visible in your Find My app, including:
- Shared locations of family/friends
- Device locations (yours and Family Sharing members)
- AirTag/item locations
User awareness: This skill uses mouse clicks and UI automation. You will see the actions happening on screen.
Known Limitations
--app "Find My"hangs in Peekaboo - use--window-idinstead- Sidebar items not accessible - Find My doesn't expose item names via accessibility APIs
- Position-based selection - Select items by position (1st, 2nd, 3rd...) not by name
- macOS only - Requires Peekaboo + OpenClaw.app bridge
- Exclusive control - User cannot interact with the Mac while skill is running (mouse/clicks conflict)
Quick Reference
| Script | Purpose |
|---|---|
fm-window.sh | Get window ID and bounds (JSON) |
fm-screenshot.sh [path] | Capture Find My window |
fm-tab.sh <tab> | Switch tab: people, devices, items |
fm-list.sh [tab] | Screenshot + show sidebar positions |
fm-select-item.sh <pos> [tab] | Select item by position (1, 2, 3...) |
fm-locate.sh <pos> [tab] | Select item and screenshot location |
fm-info.sh [path] | Open info panel, screenshot |
fm-play-sound.sh <pos> | Attempt to play sound on item |
fm-click.sh <x> <y> | Click at relative window coords |
Workflow Examples
List available items
./scripts/fm-list.sh items
# Screenshots the Items tab - view image to see your AirTags/items
Find your keys (if keys are 2nd item in list)
./scripts/fm-locate.sh 2 items
# Shows location on map, outputs screenshot path
Play sound on keys
./scripts/fm-play-sound.sh 2
# Selects 2nd item, attempts to click Play Sound
# May require manual click if button not found
Check on a family member
./scripts/fm-list.sh people
# View screenshot to see who's listed
./scripts/fm-locate.sh 1 people
# Shows first person's location
UI Layout Reference
Tab Bar (y ≈ 68 from window top)
| Tab | X Position |
|---|---|
| People | ~63 |
| Devices | ~154 |
| Items | ~243 |
Sidebar Items (x ≈ 150)
| Position | Y Coordinate |
|---|---|
| 1st item | ~120 |
| 2nd item | ~174 |
| 3rd item | ~228 |
| 4th item | ~282 |
| (spacing) | +54px each |
Manual Coordinate Clicks
When automation fails, calculate coordinates manually:
# Get window position
./scripts/fm-window.sh
# Output: {"x": 824, "y": 62, "width": 1024, "height": 768, "window_id": 2248}
# Click at relative position within window
./scripts/fm-click.sh 150 174 # 2nd sidebar item
./scripts/fm-click.sh 243 68 # Items tab
Info Panel Actions
After selecting an item, click the ⓘ button on the map popup to open the info panel:
| Action | Description |
|---|---|
| Play Sound | Make AirTag chirp (items only) |
| Directions | Open Maps with directions |
| Share | Share location with others |
| Lost Mode | Enable contact info sharing |
| Notifications | Configure alerts |
Troubleshooting
"Find My window not found"
- Ensure Find My.app is open
- Check OpenClaw.app is running (provides Peekaboo bridge)
Clicks not registering
- Window may have moved - re-run
fm-window.shfor fresh coordinates - Ensure Find My is frontmost before clicking
Can't find Play Sound button
- Open info panel manually (click ⓘ on map popup)
- Then re-run play-sound script
Future Improvements
When Peekaboo fixes --app "Find My":
- Direct element targeting without coordinate calculation
- Reliable accessibility tree for sidebar items
- Simpler automation flows