ClaudeMods
☰
EN
● 0 online · Views 0 times
SponsorsSubmit a project
GitHub repositories · by nicodunks

goodfriend

GoodFriend is a Claude Code mod that displays friends' birthdays in the spinner and reminds you to text them, pulling birthdays from Contacts and optionally iMessage.

nicodunks@nicodunks

1/

a claude code mod that remembers birthdays for you the goodfriend mod

2/

bc i felt bad forgetting @BrainsAndTennis bday claude plugin marketplace add nicodunks/goodfriend && claude plugin install goodfriend@goodfriend https://github.com/nicodunks/goodfriend

Translated

About this mod

GoodFriend is a Claude Code plugin for macOS that surfaces upcoming and recent birthdays in the Claude Code spinner and a prompt card. Birthdays come from the Contacts app or are seeded via /seed, which ranks your most-contacted people using message and group chat metadata (names only, never message content) before asking Claude to help fill in missing dates. On someone's birthday (or within a week after), a card above the prompt offers a one-tap text opening Messages with a pre-filled greeting. Commands include /seed, /goodfriend, /goodfriend add, /goodfriend remove, and /goodfriend test. Requires Claude Code 2.1.286 or newer, licensed MIT.

Installation

Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.

claude plugin marketplace add nicodunks/goodfriend
claude plugin install goodfriend
Original text / README

GoodFriend

Be a GoodFriend and remember your friends' birthdays.

GoodFriend is a Claude Code mod. Every so often, the spinner that normally says "Thinking" tells you whose birthday it is instead:

🎂 It's Maya Chen's birthday today
🎂 Leo Park's birthday is in 3 days
🎂 You missed Sam Rivera's birthday 2 days ago

On the day, and for a week after if you missed it, a small card above the prompt offers to text them:

🎂 It's Maya Chen's birthday today   [ Text Maya ]   ✕

Text Maya opens Messages with "Happy birthday! 🎂" already typed to her. You press send. Text or dismiss, and GoodFriend stops reminding you.

It doesn't nag. On someone's birthday you'll see it a few times early on, then rarely. Otherwise it's an occasional heads-up for the week ahead, or a nudge if you just missed one.

Install

/plugin marketplace add nicodunks/goodfriend
/plugin install goodfriend@goodfriend

macOS only. Needs Claude Code 2.1.286 or newer.

Where birthdays come from

  • Contacts. Anyone with a birthday set in the Contacts app. macOS asks once for permission.
  • You. Run /seed and GoodFriend works out who matters most to you (family first, then the friends you talk to most, judged from your conversations and group chats) and asks for the birthdays it doesn't know. macOS asks once to let it look at Messages; that's it. Or add one directly: /goodfriend add Maya Chen 10/7.
  • Just tell Claude. "Leo's birthday is actually March 3rd" works. Claude fixes it for you.

GoodFriend only sees who you talk to and the names of your group chats, never what you said. To rank people, it sends that list of names to Claude through your own Claude Code session. Birthdays are saved on your Mac.

Commands

| | | |---|---| | /seed | fill in birthdays for the people you text most | | /goodfriend | list everyone, soonest first | | /goodfriend add Full Name MM/DD | add or fix a birthday | | /goodfriend remove Full Name | remove one you added | | /goodfriend test | show the next birthday on your next turn |

License

MIT

Similar projects