claudegoodies
Skill

findmy

From NousResearch

Track Apple devices/AirTags via FindMy.app on macOS.

Reads Apple Find My device/AirTag locations by screenshotting the macOS app and analyzing images with vision.

Use it when

  • Asking where a registered iPhone, iPad, Mac, AirPods or AirTag is
  • Logging an AirTag's location periodically (e.g. a pet's patrol route)
  • Building a cronjob that screenshots FindMy every few minutes to build a route

Skip it if

  • macOS only, requires Find My signed into iCloud with devices already registered
  • Needs Screen Recording permission and relies on AppleScript UI automation that can break across macOS versions
  • No real API — just screenshots parsed via vision_analyze, not structured data
  • Optional dependency on third-party peekaboo tool for reliable clicking

Facts

Repository
NousResearch/hermes-agent
Status
Actively maintained
Last commit
Source file
skills/apple/findmy/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# Find My (Apple)

Track Apple devices and AirTags via the FindMy.app on macOS. Since Apple doesn't
provide a CLI for FindMy, this skill uses AppleScript to open the app and
screen capture to read device locations.

## Prerequisites

- **macOS** with Find My app and iCloud signed in
- Devices/AirTags already registered in Find My
- Screen Recording permission for terminal (System Settings → Privacy → Screen Recording)
- **Optional but recommended**: Install `peekaboo` for better UI automation:
  `brew install steipete/tap/peekaboo`

## When to Use

- User asks "where is my [device/cat/keys/bag]?"
- Tracking AirTag locations
- Checking device locations (iPhone, iPad, Mac, AirPods)
- Monitoring pet or item movement over time (AirTag patrol routes)

## Method 1: AppleScript + Screenshot (Basic)

### Open FindMy and Navigate

```bash
# Open Find My app
osascript -e 'tell application "FindMy" to activate'

# Wait for it to load
sleep 3

# Take a screenshot of the Find My window
screencapture -w -o /tmp/findmy.png
```

Then use `vision_analyze` to read the screenshot:
```
vision_analyze(image_url="/tmp/findmy.png", question="What devices/items are shown and what are their locations?")
```

### Switch Between Tabs

```bash
# Switch to Devices tab
osascript -e '
tell application "System Events"
    tell process "FindMy"
        click button "Devices" of toolbar 1 of window 1
    end te
View full source on GitHub →

Other skills