Birthday finder plugin for Muse Code

# birthday-finder

Never miss a birthday again. `birthday-finder` hunts down your friends'
birthdays across Instagram, Facebook, Messenger, and WhatsApp, then puts
them on your Google Calendar as yearly all-day events — only ever with
your approval.

## Install

**Muse Code** (plugins are now live — install from a marketplace or a
local bundle, all from `/plugins`):

```bash
git clone https://github.com/stellakaval/birthday-finder
```

Then in Muse Code, open `/plugins` and install from the local bundle
(point it at the cloned folder). Enable/disable, update, and remove all
happen from `/plugins` too, where you can also review the plugin's
runtime capabilities before enabling.

Don't have Muse Code yet? Install it with:

```bash
curl -fsSL dev.meta.ai/install.sh | bash
```

## How it works

1. **Tell it whose birthdays you want** — your Instagram Close Friends
   (default), followers, following, or specific people.
2. **It checks seven sources, all in parallel:**
   - **Facebook birthdays** — friends who share their birthday, matched
     to your list by name.
   - **Your Instagram story archive** — every archived story is
     text-scanned for birthday shoutouts ("happy birthday @sam"). The
     post date becomes the birthday.
   - **Your Instagram post captions** — same idea, for feed posts.
   - **Your Facebook posts** — your timeline plus semantic search for
     birthday shoutouts.
   - **Facebook stories** — the live story tray (no archive API exists).
   - **DMs** — Messenger and Instagram DMs keyword-searched for
     birthday wishes. Message date = birthday.
   - **WhatsApp** — chats searched for birthday wishes.
3. **You get a report** grouped by confidence, each with its evidence.
   Multiple sources confirming one date = high confidence.
4. **Only if you say yes**, the dates go on Google Calendar as yearly,
   all-day, free-time events.

## Usage

```
/birthdays
/birthdays --group followers
/birthdays --group following --sources facebook,ig-stories,whatsapp
```

Or just ask in plain language: *"find my close friends' birthdays"*,
*"whose birthday is coming up in my close friends?"*

## Why this exists

Instagram doesn't expose anyone's birthday through its API — not even
your close friends'. Facebook has the data but only for people who
choose to share it. So this plugin goes detective: your own birthday
posts and messages for other people are a