Repository navigation
Buddy 0.3.0
A pixel buddy for every Claude Code session. This release adds the command palette, double-click to jump, Diagnostics, skins (meet Crate), Mix mode, tokens and cost, opt-in SSH sessions, and a full security and quality review.
Install
- Download Buddy-0.3.0.dmg below and drag Buddy to Applications.
- Buddy is not notarized yet. On first open macOS blocks it: go to System Settings → Privacy & Security → Open Anyway.
- Follow the Welcome window: permissions, Install hooks, and Install the VS Code / Cursor extension.
- Start a new Claude Code session.
Already on 0.2.0? Replace the app, then click Install hooks again (new events: SubagentStart, SubagentStop) and install the extension again (0.1.3).
SHA-256 of the DMG: f8fe9740a33d633e48e05ecae62e89119c34b79fc58a58118a492c4f27e79760
Added
- Command palette (⌃⌥Space): sessions sorted by attention, inline cards, keyboard answers.
- Settings → Diagnostics with status rows, the last 50 hook events, and a redacted report to copy.
- Deny, Review…, Answer… and Reply… on notifications (Settings → Notifications to turn off).
- Menu → Uninstall Buddy… (hooks, extension, login item, data folder; reveals the app).
- Impatience: a buddy that waits longer than the set time (default 3 min) hops and shows a timer; at twice the time it grows and sends one reminder.
- "While you were away" digest: after a break, one buddy lists what finished, what waits, and failed subagents. Each line opens its card. Menu and palette have Show last digest.
- Fun extras (Settings → General): high-fives, a party when every session is done, and rare tips.
- Community skins from
~/Library/Application Support/Buddy/skins/, with Settings → Skins and strict checks. See docs/SKINS.md. - Skins can add whole characters; bundled example 'Crate', a pocket-console robot.
- Character → Mix gives each session a character from all enabled skins.
- Tokens and cost per session in Activity, the menu, and the palette, from an editable prices.json (not official prices; edit them for your plan).
- Opt-in SSH sessions (remote Claude Code via ssh -R socket forwarding). See docs/SSH.md.
Changed
- Double-click a buddy to jump to its terminal; Unpin moved to the right-click menu.
- Question card: Tab and Shift-Tab move keyboard focus. ←/→, Next or Return change the question. Picking an option never moves on by itself.
- Accessibility: Increase Contrast support, risk shown as text, 24 pt minimum click targets.
- Idle with only the sleeping buddy is 0.0% CPU. Hook overhead is about 4.5 ms per event.
- Next prompts keep newlines; extension 0.1.3 sends them as a bracketed paste.
- A subagent with a running background shell stays open and resumes.
Fixed
- Jump: a newer Jump cancels an older one that is still running.
- A subagent killed with TaskStop now shows "stopped".
- A subagent was marked done too early while its shell still ran.
- Name tags of buddies close together no longer overlap.
Security
- Notifications can no longer allow a request. Permission alerts offer Deny and Review…; Review… opens the armed card.
- The SSH install command no longer holds the token; it pipes a 0600 file that Buddy deletes after 10 minutes.
- The diagnostics report replaces project and host names with aliases and redacts home paths.
- ⌘⌫ in a text field no longer denies the open card.
- Hardening for token counting, prices, skins, remote peer checks, the Keychain item, the remote installer, Uninstall, CI pinning and file reads.
Full details: CHANGELOG.md.
Buddy is an unofficial fan project, not affiliated with or endorsed by Anthropic.