Claude Buddy Mac banner
Mike-Hillebrand Mike-Hillebrand

Claude Buddy Mac

AI community

Description

Pixel desktop pet for macOS that shows what Claude is doing across Claude Code, Cowork and claude.ai — built with plain swiftc, no Xcode

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Buddy — a Claude desktop pet for macOS

A little pixel buddy that floats on your desktop (no window, no card) and shows what **Claude Code** is doing right now — thinking, working, waiting for you, done — from the hooks it fires locally.

Buddy cycling through sleeping, idle, thinking, working, needs-you and done

Built with plain `swiftc` — no Xcode, no developer account, no 7-day signing expiry.

What it shows

State Source (Claude Code hooks)
working PreToolUse — a tool is running
thinking between your prompt and the next tool call
needs you permission prompt / idle prompt
ready Stop — the turn finished
sleeping no active session

Reactions: confetti + sound when something finishes, jumping `!` when Claude needs you, `x` eyes on errors, hearts when you click it, breathing / blinking / the occasional wink while idle, arms that wiggle while working. Drag it anywhere (position is remembered). Right-click or the paw icon in the menu bar opens the menu; a menu entry reveals the active session's project folder in Finder.

Extras: **wander mode** (Behavior menu) lets the buddy stroll along the edges of the screen — never across it — with a proper walk cycle, pausing when Claude needs you or your cursor comes close. And it plays **tic-tac-toe** (menu → 🎮): you are X, it thinks for a moment, gloats when it wins and sulks when it loses. It plays well but not perfectly, so you can beat it.

**Local usage line** (Behavior → *Show usage*, on by default): a small line under the buddy with today's Claude Code tokens and turn count — e.g. `⚡ 108M heute · 313×` — read straight from Claude Code's own logs in `~/.claude/projects`. No network, no cookies (s