A little more life around your notch.
Agents, focus, music, builds, and quick notes — one glance away.
Get started · Agents · Spotify · Build Watch · Settings · Contribute
Broschy is a small, native macOS companion that lives around your MacBook's notch. Hover to open it, take care of something, and get back to your work. A translucent compact strip keeps the essentials visible without opening a full window.
 |
 |
| A moment to focus. | Your music, within reach. |
Actual app views with sample data. Glass adapts to your appearance and the content behind it.
| What it does | |
|---|---|
| Agents | Monitor local Codex, Claude Code, and OpenCode sessions. See who is working, waiting for you, or ready for review. |
| Focus | Keep one task in view. Start a 25, 50, or 90-minute session, pause it, and pick up where you left off. The timer accounts for sleep. |
| Music | See the current Spotify track and artwork. Play, pause, skip, seek, and adjust Spotify's volume. The compact view keeps the title, artist, elapsed time, and animated playback bars nearby. |
| Signals | Watch GitHub Actions for a repository or pull request with Build Watch, or track local builds and tests through the bundled CLI in Commands. |
| Later | Capture a thought or your next step in a quick note that saves automatically. |
- Liquid Glass, expanded and compact. Native glass on macOS 26, with a standard macOS material on earlier versions.
- Light and Dark, automatically. Text, accents, and surfaces follow the system appearance, including Auto.
- Motion with a purpose. Smooth open/close transitions and small playback indicators; Reduce Motion and Reduce Transparency are respected.
- Your layout. Choose which tabs appear, including which modules can use the compact notch.
- Quiet Focus. Keep a running focus session in view while working-agent, error, and result indicators stay out of the compact notch. Fresh agent questions and permission requests can still interrupt.
- Native and small. SwiftUI, AppKit, a bundled CLI, and no third-party Swift dependencies. English throughout.
Current version: 0.8.2. Download the Apple Silicon preview, or build it locally with Xcode 26 or later and its macOS SDK. The app's deployment target is macOS 14; hands-on validation has been on macOS 26 and Apple Silicon. The local build produces an app for your Mac's architecture.
git clone https://github.com/SculptTechProject/Broschy.git
cd Broschy
bash build.sh
open build/Broschy.appThe build script assembles build/Broschy.app and signs it locally with an ad hoc signature. It does not install the app in Applications. There is currently no notarized public download or App Store build.
| Action | How |
|---|---|
| Open the panel | Hover over the notch or click the compact strip |
| Toggle the panel | Control + Option + N, or the menu bar icon |
| Keep it open | Click the pin |
| Settings | The header gear, Settings… in the menu bar menu, or Command + , |
| Hide it | Esc or the chevron in the panel |
| Quit Broschy | ⋯ → Quit Broschy, the menu bar menu, or Command + Q while the panel has focus |
Look for Broschy's notched-screen icon in the menu bar. It is a native monochrome template that adapts to light and dark menu bars.
Hiding the panel keeps Broschy running. To reopen it after quitting, launch Broschy.app. Broschy has no Dock icon and does not automatically start at login. On a screen without a notch, it appears at the center of the top edge.
Open Settings… to choose your visible tabs and turn Quiet Focus on or off. All five tabs are visible by default. Hiding a module also removes its compact indicator; its timer, playback, monitoring, or other background work continues. At least one tab stays visible, and hiding the selected tab moves the panel to a visible one.
Quiet Focus is off by default and applies only while the countdown is running. It keeps working-agent, error, and command or workflow result indicators out of the compact notch. Fresh agent questions and permission requests can still interrupt. Responses stay in Agents → Ready to review and never take over the compact notch; unreviewed failures stay in Agents → Errors. Pausing or finishing the timer restores normal compact priority, including red error indicators.
These preferences affect Broschy's presentation. They do not change the macOS Focus mode or notifications from other apps. Resetting them restores the default layout and turns Quiet Focus off; connections, notes, timers, and history are retained.
Sample sessions in Dark appearance.
Open Agents → Connections to connect Codex, Claude Code, or OpenCode. Restart the connected tool; Codex may require you to review the new hooks with /hooks. Sessions appear when they send an event.
Needs you contains only fresh, actionable questions and permission requests. Stopped responses appear separately in Ready to review and never take over the compact notch. Unreviewed failures appear in Errors and can show a red compact indicator when Quiet Focus is not running. Session actions let you copy a terminal resume command, open the project folder, and mark a response or error reviewed.
This is a local monitor for supported CLI hooks and plugins: it does not open transcripts or store prompts, tool arguments, or output. It does not send prompts, approve tools, or stop agents. The Codex desktop app is not currently a verified integration. Activity is checked against the originating process when available; stale activity becomes “Status unknown” instead of staying “Working”. “Ready to review” means a response stopped, not that the task necessarily succeeded. Setup needs Python 3. See the integration guide for compatibility, configuration, removal, and limitations.
- Open the Spotify desktop app on your Mac.
- In Broschy, choose Music → Connect Spotify.
- Allow Broschy to control Spotify when macOS asks.
That's it. No Spotify API key, developer account, or login inside Broschy is needed. If no track is selected, choose one in Spotify first.
The connection uses local Apple Events. ⋯ → Disconnect Spotify stops monitoring without stopping your music. If access was denied, use Open Settings, then allow the app under Privacy & Security → Automation. macOS may list an existing installation under its previous name, NotchFlow.
Playback bars indicate whether music is playing; they do not analyze audio or use the microphone. Spotify volume is separate from system volume. Browser playback, music search, and choosing a Spotify Connect device are not supported.
Sample workflow runs in Dark appearance.
In Signals → Build Watch, connect one GitHub.com repository or pull request:
- Install GitHub CLI (
gh) and sign in withgh auth loginif needed. - Enter
owner/repository, a repository URL, or a pull request URL. - Leave the branch blank to use the repository's default branch, or enter a branch name. A pull request follows its current head commit.
Broschy uses your existing GitHub CLI access and checks up to ten recent workflow runs about every 30 seconds. Failed requests retry less often. A workflow observed active and then completed can show its result in the notch for 12 seconds; existing completed runs on first connection are silent, and repeated results are deduplicated. Runs that finish entirely between polls appear in the list but do not trigger a compact result. Compact visibility and Quiet Focus still apply.
Each row shows a fixed Updated date and time from GitHub, not a running duration. A completed workflow appears after the next successful poll; use Refresh for an immediate check.
Open a workflow in GitHub to inspect it. Build Watch only reads status: it does not download workflow logs, rerun jobs, cancel workflows, or merge pull requests. GitHub Enterprise hosts and watching several targets at once are outside this version. Disconnect to stop polling.
The Signals → Commands subtab keeps the local CLI workflow. From the repository directory:
# Run a command and show its result in Broschy.
./build/Broschy.app/Contents/MacOS/broschy-cli run --label "Build" -- swift build
# Run Broschy's own checks.
./build/Broschy.app/Contents/MacOS/broschy-cli run --label "Tests" -- bash test.sh
# Send a result from your own script.
./build/Broschy.app/Contents/MacOS/broschy-cli notify --title "Ready to review" --status succeededYou can also use Signals → Commands → Copy command for an example with the correct path to your copy of the app. The CLI forwards the command's input/output and exit status. Arguments are executed directly; pass a shell explicitly if you need a pipeline.
Commands shows work run through Broschy’s CLI and results you explicitly send. It does not inspect other terminal sessions or IDEs; GitHub workflow monitoring is handled separately by Build Watch. Control + C records cancellation; a forced kill or shutdown can leave a command marked Running. Cancellation is forwarded to the direct child process.
The task, timer, note, and command history are stored locally. Broschy has no account, analytics, or cloud sync. Agent snapshots contain session and project identifiers, status, generic activity labels, and timestamps; prompts and tool contents are not saved. Integration setup retains local configuration backups. Command records contain a label, working directory, status, timestamps, and an exit code when available; command arguments and output are not saved. Album artwork is fetched over HTTPS from URLs returned by Spotify. No listening history or Spotify tokens are stored.
Build Watch is opt-in and contacts GitHub.com through gh, using the credentials GitHub CLI already manages. Broschy does not request, extract, or save GitHub tokens. The selected target, enabled state, and a bounded set of completion identifiers are saved in local preferences; fetched workflow metadata stays in memory. Full CI logs are not downloaded or stored. Layout and Quiet Focus preferences are also stored locally.
For compatibility with earlier installations, the storage folder remains:
~/Library/Application Support/NotchFlow/
├── state.json
├── jobs/
└── agents/
Use Open Broschy Data from the menu bar to find it. The legacy bundle identifier is also retained so existing preferences and macOS permissions keep the same application identity. See development notes for details.
bash test.sh # Isolated core, agents, preferences, priority, and mocked integration checks
bash build.sh # Release app bundle, icon, and local signatureTests use isolated data and mocked Spotify and Build Watch responses. They cover saved layout preferences, Quiet Focus, and compact priority without controlling your player or changing GitHub workflows. UI appearance, physical notch placement, and macOS Automation prompts still need manual checks. See development notes, design notes, and contributing.
Multi-display setups, Stage Manager, full-screen apps, and an auto-hidden menu bar need broader device testing. These are the main areas where feedback is useful.
MIT · Built by SculptTechProject.
An independent project, not affiliated with Apple or Spotify.