Buddy — Development skill for Claude Code

Buddy

**A little pet that lives on your Mac and tells you when Claude Code or Codex needs you.**

You start an AI agent on a task, switch to email, and forget about it. Buddy sits at the bottom of your screen, watches your agents, and taps you on the shoulder when one is done or waiting for your OK. One click takes you straight back to it.

git clone https://github.com/varun-ml/buddy.git ~/buddy && ~/buddy/install.sh

That's the whole install. Buddy builds on your Mac in about a minute and starts right away. **Everything stays on your Mac: no account, no tracking, nothing sent to us.**

---

What Buddy does for you

• Tells you when an agent is done, with its own one-line summary: "Rewrote email 2: shorter, one clear call to action." Click the bubble and you're back in that chat or terminal.
• Tells you when an agent is waiting for your OK, with a soft sound, so it doesn't sit idle for an hour.
• Lets agents talk to you. Any agent can put a message on your screen ("Tests are green, ready to merge"). See Let your agents message you.
• Shows everything at a glance. Hover over Buddy to see what's running, what's finished, and how much of your plan you've used.
• Looks after your day: nudges you to take a break after 90 minutes, warns you when you're juggling too many agents at once, and tells you when it's time to stop.

Two tabs: Work and Personal

**Work** is what your agents are doing: what's running, what's done, your usage limits, and (if you co