Claude Buddy

Claude Buddy is a small companion for Claude Code. A mascot sits on the desktop, always on top, and changes mood with what Claude is doing: typing and sparks while it works, amber with an exclamation mark when it needs permission, a jump and confetti when a turn finishes, zzz when idle. Click it and a panel opens with the numbers that actually matter mid-session: the 5-hour and weekly rate limits with reset countdowns, extra-usage credits, and every open session with its current tool, token counts and cost.

Three sources, one state

Nothing in Claude Code exposes this directly, so Buddy assembles it. Hooks (SessionStart, PreToolUse, Stop and the rest) post to a local server on port 4747 and give the live state per session. Transcript files are tailed incrementally for token usage, with streamed chunks deduplicated so nothing is counted twice. The usage endpoint behind the CLI’s own /usage command, called with the existing login, gives the rate limits. A one-off setup script wires the hooks and an optional statusline into Claude Code’s settings, backs the file up first, and can remove everything again.

From the couch

The panel has a phone icon. Scan the QR code and the same limits, sessions and activity open on a phone over WebSocket, installable to the home screen. It is read-only by design: approving a permission prompt from the phone would need a real bridge into the CLI, and a half-working version of that is worse than none.