https://github.com/dgpisces/bough
A macOS notch companion for AI coding agents.
https://github.com/dgpisces/bough
ai-tools macos notch sparkle swift swiftui
Last synced: 8 days ago
JSON representation
A macOS notch companion for AI coding agents.
- Host: GitHub
- URL: https://github.com/dgpisces/bough
- Owner: DGPisces
- License: mit
- Created: 2026-05-10T06:34:35.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-02T21:51:02.000Z (10 days ago)
- Last Synced: 2026-06-02T23:08:17.972Z (10 days ago)
- Topics: ai-tools, macos, notch, sparkle, swift, swiftui
- Language: Swift
- Homepage:
- Size: 3.66 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Bough
Bough is a macOS notch utility that keeps AI coding agents, usage, music, lyrics, and AirDrop state visible at the top of your screen.
## Features
- Shows session state for Codex, Claude Code, Cursor, and other supported tools in the notch area.
- Surfaces permission requests, questions, completion, busy, and idle states, with jump-back support to the matching terminal or app.
- Tracks AI usage windows with optional usage and recovery notifications.
- Displays music playback, lyrics, and AirDrop drag surfaces.
- Supports local, remote SSH, and common terminal/editor workflows.
- Includes the Bough mascot, tool mascots, pixel sounds, diagnostics, and Settings previews.
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 | 
|
## Install
The current stable release is `v1.0.0`.
1. Open [GitHub Releases](https://github.com/DGPisces/bough/releases).
2. Download the latest `Bough.dmg`.
3. Open the DMG and drag `Bough.app` into `/Applications`.
4. On first launch, follow macOS prompts for opening the app and granting required permissions.
## Automatic Updates
Bough uses the public repository stable channel for automatic updates. Stable builds check the public update feed for signed in-app updates.
## Build From Source
Requires macOS 14+, Swift 5.9+, and Xcode Command Line Tools.
```sh
swift package resolve
swift build -c release
swift test
```
The release executable is `.build/release/Bough`.
## Contributing
See [`CONTRIBUTING.md`](CONTRIBUTING.md). Report security issues through GitHub private vulnerability reporting.
## Thanks
Thanks to [CodeIsland](https://github.com/wxtsky/CodeIsland) for providing the foundation. See [`CREDITS.md`](CREDITS.md) for license and third-party notices.
## License
Bough is released under the MIT License. See [`LICENSE`](LICENSE).