Features

Claude Code Integration

• Live session monitoring — Track multiple concurrent Claude Code sessions in real-time
• Permission approvals — Approve or deny tool executions directly from the notch
• Chat interface — View full conversation history with markdown rendering, send messages back
• Usage tracking — Session and weekly utilization at a glance
• Multiplexer support — Works with cmux and tmux sessions
• Auto-setup — Hooks install automatically on first launch

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 generated from your system, with different eyes, hats, rarity levels, and personality stats. They animate through idle, working, reading, sleeping, and error states — matching what Claude Code is doing.

Notch Utility

• Music player — Album art, playback controls, and audio visualizer
• Calendar — Upcoming events at a glance
• Battery — Status and charging indicator
• HUD replacement — Custom volume and brightness overlays
• File shelf — Drag-and-drop file staging area
• Webcam preview — Quick mirror from the notch
• Keyboard shortcuts — Customizable hotkeys

Requirements

• macOS 15.0+ (Sequoia)
• MacBook with notch (or external display support)
• Claude Code installed

Install

Homebrew

brew install --cask talkvalue/buddi/buddi

Manual Download

Download the latest .dmg from the Releases page.

How It Works

Claude Code → Hooks → Unix Socket → Buddi → Notch UI

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

Building from Source

1. Clone the repo
2. Open buddi.xcodeproj in Xcode 16+
3. Build and run — SPM dependencies resolve automatically

Acknowledgements

Buddi is built on top of open-source work by others:

• boring.notch by TheBoredTeam — The notch UI framework that Buddi is built upon. Music player, calendar, battery, HUD replacement, file shelf, and the core notch rendering system all come from boring.notch.
• Claude Island by farouqaldori — The predecessor to Buddi. Claude Code session monitoring, hook system, buddy characters, and the chat interface originate from Claude Island.

See NOTICE for full attribution and licensing details.

License

This project is licensed under the GNU General Public License v3.0.