Buddi

Product Introduction

1. Definition: Buddi is a native macOS productivity utility and terminal companion specifically engineered to interface with Anthropic’s Claude Code CLI. Categorized as a "Notch Utility" and "Developer Tool," it is built using Native Swift and SwiftUI to provide a lightweight, high-performance visual layer for command-line AI interactions.

2. Core Value Proposition: Buddi exists to restore and enhance the "buddy" experience that was originally part of the Claude Code ecosystem. By residing in the MacBook notch, it eliminates the need for constant terminal switching by providing real-time status updates, visual feedback via ASCII animations, and a centralized permission-handling interface. It optimizes the Developer Experience (DX) for users of AI-driven terminal agents by turning abstract background processes into glanceable, interactive data.

Main Features

1. Reactive ASCII Buddy System: Buddi features 18 distinct species of ASCII characters, ranging from "Common" to "Legendary" rarity tiers. Each buddy is equipped with unique visual traits, including eyes and hats, and features personality stats. More importantly, these characters utilize a state-machine architecture to animate in real-time based on the Claude Code lifecycle: working (processing), reading (file I/O), sleeping (idle), or erroring out.

2. Integrated Notch Permission Management: One of the most significant technical hurdles in CLI-based AI development is the interruption of tool calls requiring user approval. Buddi solves this by allowing developers to approve or deny Claude Code permissions directly from the macOS notch. This reduces context switching and maintains flow state during complex automated coding tasks.

3. Multi-Session Monitoring & Multiplexer Support: Buddi is designed for power users who run multiple concurrent AI sessions. It features native support for cmux and tmux, allowing it to track multiple Claude Code sessions simultaneously. Each session is assigned its own buddy, enabling the user to monitor several long-running refactors or test-server deployments from a single dashboard.

4. Universal Notch Utility Suite: Beyond its AI-specific capabilities, Buddi functions as a comprehensive macOS notch enhancement tool. It integrates a "File Shelf" for temporary storage, music playback controls (supporting platforms like Spotify/Apple Music), calendar event previews, and battery health monitoring, all optimized for the specific hardware constraints of the MacBook notch.

Problems Solved

1. Pain Point: Terminal Blindness and Context Switching: Developers using Claude Code often lose track of background processes or miss permission prompts while working in other applications. Buddi addresses "terminal blindness" by providing a persistent, non-intrusive visual indicator in the notch.

2. Target Audience: The primary users are Software Engineers, DevOps Professionals, and AI Researchers who utilize the Claude Code CLI for automated code generation, refactoring, and system debugging. It is also tailored for macOS enthusiasts who want to maximize the utility of the MacBook's hardware notch.

3. Use Cases:

• Large-scale Refactoring: Monitoring a long-running AI script while reviewing documentation in a browser.
• Concurrent Debugging: Running multiple "test-server" and "fix-scraper" sessions while tracking their individual progress via distinct ASCII buddies.
• Hardware-Efficient Utility: Users looking for an open-source, native alternative to bloated electron-based menu bar utilities.

Unique Advantages

1. Differentiation: Unlike traditional menu bar apps that clutter the system tray, Buddi is specifically designed for the MacBook notch, utilizing the unused space around the camera housing. While Anthropic removed the internal /buddy feature from Claude Code, Buddi provides a superior, extensible, and persistent version that operates at the OS level.

2. Key Innovation: The integration of a "Tamagotchi-style" reward system (rarity tiers and species) with professional-grade developer tooling (permission hooks and tmux integration). This gamification of the development environment increases engagement without sacrificing the technical utility required for high-level programming.

Frequently Asked Questions (FAQ)

1. Is Buddi compatible with all versions of macOS? Buddi requires macOS Sequoia (v15.0 or later) to function correctly, as it utilizes specific native SwiftUI APIs and notch interaction behaviors introduced in recent macOS iterations.

2. How does Buddi connect to my Claude Code sessions? Buddi monitors active terminal sessions and integrates with cmux/tmux to pipe status updates from the Claude Code CLI to the notch interface. This allows it to react to tool calls, thoughts, and errors in real-time.

3. Is Buddi an open-source project? Yes, Buddi is entirely open-source and free to use. Developers can contribute to the codebase, add new buddy species, or audit the security of the permission-handling hooks via the official GitHub repository.

4. Does Buddi collect any sensitive code data? No. As a native Swift application, Buddi acts as a visual wrapper for your local CLI sessions. It facilitates permission approvals but does not upload your source code to external servers beyond the standard Anthropic API calls made by Claude Code itself.