Beepo Support

A menu-bar pet that pings you when your Claude Code task is done.

Requirements

macOS 14 (Sonoma) or later
Claude Code installed and in use

Setup (one time, ~1 minute)

Launch Beepo. A small pet appears in your menu bar (top-right of the screen).
When prompted, allow notifications so Beepo can tell you when a task finishes.
Add the Beepo hook to Claude Code. Open the Beepo menu and follow the "Connect to Claude Code" steps, or paste the provided snippet into your ~/.claude/settings.json. This is what lets Claude Code tell Beepo a task finished.

That's it. Send a prompt in Claude Code and watch the pet start walking; when the turn ends it celebrates, and (if you're not looking at the terminal) you get a notification like "my-project - Done · 2m 14s".

What the pet's states mean

Idle - nothing running.
Working - Claude Code is on a task (dots animate below the pet).
Done - the task finished (sparkles + happy face), then back to idle.
Error - the task hit an API error (rate limit, server error, etc.).
Confused - Claude is waiting for your input.

If you run several Claude Code sessions at once, the pet shows the most important state across all of them - it stays "working" until every session has finished.

Settings

Click the pet to open the menu. You can rename the pet, toggle the completion sound, stay silent while you're focused on the terminal, launch Beepo at login, and skip notifications for very short tasks.

Troubleshooting

The pet doesn't react when Claude Code runs

Make sure the Beepo hook is installed in ~/.claude/settings.json and that Beepo is running (look in the menu bar). Re-run the connect step from the Beepo menu if needed.

I'm not getting notifications

Check System Settings → Notifications → Beepo and make sure notifications are allowed. Also note Beepo stays silent by design while you're focused on a terminal app - switch to another app to test, or turn that option off in Beepo's settings.

Very short tasks don't notify

By default Beepo skips notifications for tasks under 10 seconds (so trivial edits don't spam you). Change the threshold to "Always notify" in Beepo's settings.

How do I remove the Claude Code hook?

Use the uninstall snippet from Beepo's menu, or remove the Beepo entries from ~/.claude/settings.json yourself. Beepo never edits that file for you.

Contact

Need help or have a feature request? Email support@hedgielabs.com.