FAQ
Questions people ask.
Is it really free?
Yes. WorkKit Buddy is a free product from WorkKit for anyone on macOS or Windows. No account, no trial, no upsell inside the app.
Does it record my audio or my screen?
No. To dance it measures the loudness and beats of what your computer is playing, live, in memory, and discards the audio immediately. It never records, saves or uploads anything. It doesn't look at your screen at all.
How does it know what song is playing?
On macOS it asks Spotify or Music what they're playing and reads music-site titles from your browser tabs (macOS will ask once per browser). On Windows it uses the system's media-session information — the same thing the volume flyout shows. The title is only shown to you in the menu.
Can I use my own character?
Yes. Right-click the buddy › Character › Use my own image…, or drag a picture onto it. Plain backgrounds are removed automatically and it gets the same animations as the built-in characters. Custom characters are stored in your user folder and survive updates.
It's in the way / I want it somewhere else.
Drag it anywhere; it stays where you drop it. Turn on Ghost mode to let clicks pass through it, use Hide (or the hotkey ⌃⌥H on Mac) to make it vanish, and Quiet hours to stop the chatter in the evening.
How do I connect it to Claude Code?
Right-click › Claude Code › Connect. It adds hooks to ~/.claude/settings.json (a backup is kept next to it) so the buddy reacts when Claude is thinking, editing, testing, waiting for you, finished or hit an error. Disconnect removes them again.
Can my scripts talk to it?
Yes — it registers a URL scheme. From a terminal or any tool that can open a link:
macOS: open -g "workkitbuddy://notify?title=Deploy&text=Production%20is%20live&url=https://workkit.in"
Windows: start "" "workkitbuddy://say?text=hello"
Found a bug, or have an idea for a character?
Tell us through the WorkKit contact page. Include your OS version and, for Mac, the log at ~/Library/Logs/WorkkitBuddy.log (Windows: %APPDATA%\WorkkitBuddy\WorkkitBuddy.log) if something misbehaves.
How do I uninstall it?
Mac: quit it from the menu, then delete WorkKit Buddy from Applications and WorkKit Buddy.saver from /Library/Screen Savers. Windows: Settings › Apps › WorkKit Buddy › Uninstall. Your settings and custom characters are kept unless you delete them yourself.