Skip to content

talkvalue/Buddi

Buddi

A macOS notch companion for Claude Code — with a buddy that lives in your notch.

What it does

  • Your own ASCII buddy character lives in the notch and reacts to Claude Code in real time
  • Approve or deny tool calls directly from the notch — no need to switch to the terminal
  • Chat with active Claude sessions from the notch panel
  • Track multiple concurrent Claude Code sessions, each with its own buddy
  • Works with cmux and tmux multiplexed sessions
  • Lock screen widget so your buddy is always with you
  • Sound notifications for session events
  • Full notch utility: media controls, battery, timer, calendar, clipboard shelf, and more

Buddy Characters

18 species — duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, and chonk. Each buddy has a unique identity with different eyes, hats, rarity, and personality stats. They animate through states like idle, working, reading, sleeping, and error — matching what Claude Code is doing.

Requirements

Install

  1. Clone the repo and open DynamicIsland.xcodeproj in Xcode 16+
  2. Build and run — dependencies resolve automatically via SPM
  3. Launch Buddi — it auto-installs Claude Code hooks on first launch
  4. Start using Claude Code and watch your buddy react

How it works

Claude Code → Hooks → Unix Socket → buddi → Animated Buddy

Buddi registers hooks with Claude Code on launch. When Claude Code emits events (tool use, thinking, session start/end, permission requests), the hooks send them to Buddi over a Unix socket. The app maps events to buddy animations and, when Claude needs permission, expands the notch with approve/deny buttons.

Credits

See NOTICE for full attribution and licensing details.

License

GPL-3.0-only — see LICENSE


Built by TalkValue — we build tools for people who build with AI.

Event Intelligence Playbook · our weekly newsletter on AI + events

About

Your always-on desktop buddy for the macOS notch — built on top of Atoll

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Contributors

Languages