Bobber
A native macOS floating companion for monitoring multiple Claude Code sessions at a glance.
What it does
Bobber sits as a floating panel on your desktop, showing all your active Claude Code sessions in real-time. It watches for events via a Claude Code plugin, displays session status, pending permissions, and lets you jump between terminal windows.
Key features:
- Floating always-on-top panel that doesn't steal focus
- Real-time session monitoring with status indicators (active / idle / blocked / completed)
- Priority system (Focus / Priority / Standard) for organizing sessions
- Permission request cards with approve/deny actions via Unix socket IPC
- Global hotkey (Option+B) to toggle the panel
- Menu bar icon with session count
- Jump-to-terminal for any session
Install
# Clone and build
git clone https://github.com/winrey/bobber.git
cd bobber
swift build -c release
# Copy the built app
cp -r .build/release/Bobber /usr/local/bin/
# Install the Claude Code plugin
cp -r plugins/claude-bobber-plugin ~/.claude/plugins/
Usage
# Run Bobber
swift run
# or after installing to PATH
Bobber
Then start any Claude Code session — Bobber will automatically detect and display it.
Controls:
Option+B— Toggle panel visibility- Click a session row — View session details
- Right-click a session — Set priority, rename, or hide
- Right-click a project header — Set default priority for all sessions in that project
Architecture
Sources/Bobber/
├── Models/ # BobberEvent, Session, PendingAction, SessionPriority, BobberConfig
├── Services/ # SessionManager, EventFileWatcher, PermissionServer, HotkeyManager, ...
└── UI/ # FloatingPanel (NSPanel), PanelController, SessionRowView, ...
- Event pipeline: Claude Code plugin writes JSON events to
~/.bobber/events/→ FSEvents watcher picks them up → SessionManager updates state → SwiftUI views react - Permission IPC: Unix domain socket at
/tmp/bobber.sock— plugin sends permission requests, Bobber shows cards, user decides, response flows back - Zero dependencies: Pure Swift + SwiftUI + AppKit, built with SPM
Requirements
- macOS 13 (Ventura) or later
- Swift 5.9+
- Claude Code CLI
License
MIT