Bough is a macOS menu bar utility that keeps AI coding agent status, usage, music, and AirDrop visible at the top of your screen.
- Shows session state for Codex, Claude Code, Cursor, and other supported tools right in the Mac notch / menu bar.
- Permission requests, questions, completion, busy, idle — every state at a glance. Click to jump back to the matching terminal or editor window.
- Tracks daily usage for Codex and Claude Code. Alerts you when you're approaching the limit, and lets you know when the cooldown is over.
- Now playing music and lyrics, right in the menu bar — no need to switch windows.
- AirDrop drag panel for faster file reception.
- Works whether you're developing locally, SSH'd into a remote server, or using any common terminal and editor.
Supported tools
| Tool | Bough mascot |
|---|---|
| Codex |  |
| Claude Code |  |
| Cursor |  |
| GitHub Copilot |  |
| Gemini CLI |  |
| OpenCode |  |
| Qwen Code |  |
| Kimi |  |
| Trae |  |
| Qoder |  |
| Antigravity |  |
| CodeBuddy |  |
| WorkBuddy |  |
| Droid |  |
| Hermes |  |
| StepFun |  |
brew tap DGPisces/tap
brew install --cask bough- Open GitHub Releases.
- Download the latest
Bough.dmg. - Open the DMG and drag
Bough.appinto/Applications. - On first launch, follow the macOS prompts to confirm and grant the required permissions.
-
Homebrew Cask installs — let Homebrew handle it:
brew update brew upgrade --cask bough
-
DMG installs — Bough has a built-in updater. Stable builds check the public stable channel for signed updates.
Requires macOS 14+, Swift 5.9+, and Xcode Command Line Tools.
swift package resolve
swift build -c release
swift testThe release binary is at .build/release/Bough.
See CONTRIBUTING.md. Report security issues through GitHub private vulnerability reporting.
Bough is a fork of CodeIsland — thanks to the original project for laying the foundation. See CREDITS.md for license and third-party notices.
Bough is released under the MIT License. See LICENSE.