Agent Buddy for WorkBuddy

A tiny macOS desktop pet that shows your WorkBuddy credits and live agent status.

Language: English · 简体中文

Download · Privacy · Build from source

Agent Buddy turns WorkBuddy into a small desktop companion: it stays quietly on your desktop, changes mood with the current agent state, and reveals your credit balance when you hover over it.

It is designed for people who keep an AI coding agent running for long sessions and want a lightweight “at-a-glance” status surface instead of constantly switching back to the main app.

Highlights

• Desktop pet for WorkBuddy on macOS
• Hover card with available credits, remaining percentage, total credits, plan, and update time
• Near real-time WorkBuddy lifecycle status through a local hook bridge
• Built-in Kitty Buddy / Cat Buddy visual theme
• Menu bar control panel
• Launch at login
• Local-first: no analytics server, no account upload, no prompt/content collection

Status gallery

Each state has a dedicated visual so you can see what the agent is doing without opening the WorkBuddy window.

Idle	Planning	Thinking

Running tool	Waiting for you	Done	Failed

Download

1. Star this repo if the project helps you. It helps the project reach more WorkBuddy users.
2. Open Releases.
3. Download the latest Agent-Buddy-WorkBuddy-*.dmg.
4. Open the DMG and drag Agent Buddy.app into Applications.

The downloadable app is packaged for normal users. You do not need to install Xcode, Node.js, XcodeGen, Homebrew, or any developer dependency just to run the app.

First launch on macOS

The current public build is ad-hoc signed. If macOS blocks the first launch:

1. Open System Settings.
2. Go to Privacy & Security.
3. Find the blocked Agent Buddy message.
4. Click Open Anyway.
5. Launch Agent Buddy again.

Future notarized builds should reduce this friction.

Enable live WorkBuddy status

Credits can be read by the app directly after WorkBuddy is installed and logged in. Live agent status needs the local WorkBuddy status plugin.

From the repository root:

node Scripts/install-workbuddy-status-plugin.mjs

Then restart WorkBuddy and make sure the plugin is enabled in WorkBuddy.

The plugin writes a small local JSONL spool at:

~/.workbuddy-buddy/events.spool

Agent Buddy watches that local file and maps WorkBuddy lifecycle events to desktop pet moods.

Privacy

Agent Buddy is local-first.

• It does not upload your WorkBuddy account data.
• It does not collect prompts, answers, transcripts, file paths, tool arguments, or tool results.
• The status plugin keeps only a tiny structural whitelist: event name, timestamp, session id, tool name, permission mode, notification type, and a boolean that indicates whether the last assistant message ended with a question.
• The hook is fail-open: if it cannot write status, it silently drops the status event and never blocks WorkBuddy.

See PRIVACY.md for the full privacy note.

Build from source

Requirements:

• macOS 13 or later
• Xcode
• Optional: XcodeGen, only needed if you edit project.yml

Build and package:

VERSION=0.2.1 BUILD_NUMBER=22 ./Scripts/package.sh

Output:

dist/Agent Buddy.app

Open in Xcode:

open AgentBuddy.xcodeproj

Roadmap

• More visual themes
• Theme import/export
• Windows portable build
• Multi-agent adapter layer
• Auto-update channel
• Developer ID signed and notarized macOS releases

Name and trademarks

WorkBuddy is a product name owned by its respective owner. This project is an independent community tool and is not affiliated with or endorsed by WorkBuddy.

The included Kitty Buddy / Cat Buddy theme is provided as a replaceable demo theme. If you redistribute or commercialize a build, make sure your theme assets are properly licensed.