Find My

Control the native Find My app via Peekaboo. No sketchy APIs or credential sharing.

Run scripts from: cd {skillDir}

Requirements

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

1. --app "Find My" hangs in Peekaboo - use --window-id instead
2. Sidebar items not accessible - Find My doesn't expose item names via accessibility APIs
3. Position-based selection - Select items by position (1st, 2nd, 3rd...) not by name
4. macOS only - Requires Peekaboo + OpenClaw.app bridge
5. Exclusive control - User cannot interact with the Mac while skill is running (mouse/clicks conflict)

Quick Reference

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)

Sidebar Items (x ≈ 150)

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:

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.sh for 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