claudeers.
// Automation & Workflows

broglow

Desk traffic light for AI coding agents: menu-bar app, terminal dashboard and DIY ESP32-C3 lamp for Claude Code, Codex, opencode and Copilot CLI.

// Automation & Workflows[ cli ][ api ][ desktop ][ web ][ claude ]#claude#3d-printing#ai-agents#ble#claude-code#codex#copilot#esp32#automation◷ MIT$open-sourceupdated 28 days ago
Actively maintained
100/100
last commit 12 days ago
last release 12 days ago
releases 12
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up broglow (git-clone project) into my current project.
Found on https://claudeers.com/broglow
Repo: https://github.com/BroGlow/broglow
Homepage/docs: https://broglow.github.io/broglow/
Detected install method: git-clone → git clone https://github.com/BroGlow/broglow
Category: automation. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/BroGlow/broglow

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageRust

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

English | Русский

BroGlow

A local session monitor for Claude Code, opencode, Codex and GitHub Copilot CLI, with a menu-bar app, terminal dashboard and optional ESP32-C3 status lamp. The lamp, connected over USB or Bluetooth LE, shows working, idle and needs-input states.

You can install and configure BroGlow before you build or get a lamp. The app and terminal dashboard already show your local agent sessions and their status without any hardware; add a lamp whenever you're ready.

The BroGlow lamp with all three lights glowing red, yellow and green, next to the orange mascot

Read the guide on the website: install, build the lamp, connect Codex and fix problems.

Maintained by Suren Khorenyan. Copyright notices are in LICENSE.

The BroGlow lamp with only the yellow light glowing, matching the app's paused-session status The BroGlow menu-bar popover: three live sessions, one working and two paused, with Dashboard, Settings and Lamps controls

How BroGlow differs from ClawLight

BroGlow is a separate, independently maintained application inspired by ClawLight. Most of the app has been rewritten, with a substantially redesigned interface and expanded capabilities:

Sessions

What's betterWhat you gain
Open the right conversationClick a session to land in its Claude desktop chat, Codex desktop task or terminal window.
Real session namesSessions carry Claude's own titles and renamed Codex tasks instead of "Session abc123".
Agent and host at a glanceEach row shows which agent is working (Claude, Codex, opencode, Copilot) and where (desktop app, terminal, IDE).
Group by projectSessions sit under one heading per working directory; same-named folders are told apart.
Improved status handlingWorking, idle and needs-input states follow what the agent is doing more closely, for Claude and Codex alike.
Clear paused sessionsRemove clutter in one click while keeping active work and approval requests visible.

Lamp

What's betterWhat you gain
Wireless lamp connectionPut the lamp anywhere in Bluetooth range; no data cable to the Mac.
Plug in, pairedA new USB-attached lamp pairs itself on macOS; Add lamp retries manually.
Lamps managed one at a timeName or forget one lamp; the others stay connected, with status for each.
Brightness with live previewAdjust each lamp to a comfortable level and see the result before saving.
Identify a lampA three-pass scan on the selected lamp shows which one it is.
Safe firmware flashingOne locked toolchain flashes and backs up the board the same way on every machine.

Install and upkeep

What's betterWhat you gain
Homebrew installbrew install broglow/tap/broglow, then broglow install; upgrades the same way.
Upgrades that don't breakConfig writes are atomic, a failed macOS upgrade rolls back, dotfile symlinks survive, uninstall removes every hook.
Track token usageOpt-in view of your plan's 5-hour and weekly percentages and today's tokens, Claude and Codex together.
120 fps popoverThe menu-bar interface renders at your display's full refresh rate.

Build and docs

What's betterWhat you gain
Print the enclosure, swap the mascotThe mascot holds on by magnets: attach any mascot you like and change it anytime.
Interactive assembly guideRotate and zoom the separated parts.

Bluetooth lamp features (including naming, brightness and Identify) and direct opening of desktop sessions are macOS-only.

Start here

For a new or unflashed C3, follow the flashing and backup instructions.

PlatformPackageLamp
macOSApp, C3 firmware and manualsUSB or Bluetooth LE
WindowsTray app and CLI; no installer, firmware or manualsUSB
LinuxBuild from sourceUSB

GitHub Releases also provide the enclosure as a separate download.

Install

On macOS, the quickest route is Homebrew, followed by the required broglow install, which registers the hooks in your coding agents, installs the app and starts it at login:

brew install broglow/tap/broglow
broglow install

To install a specific release instead, use broglow/tap/broglow@VERSION, for example brew install broglow/tap/[email protected]; brew prints how to put it first on your PATH.

Alternatively, download the full Mac package for your architecture and its matching .sha256 file from Releases. Follow the checksum and installation steps. Builds are not signed with a Developer ID or notarized by Apple; the manual describes macOS's normal per-app approval flow.

On Windows, extract broglow-vVERSION-x86_64-pc-windows-msvc.tar.gz from Releases into a permanent folder (for example, tar -xf <file> in PowerShell). In PowerShell from that folder, run .\broglow.exe install to register hooks, enable startup at login and launch the tray app. .\broglow.exe menubar launches the graphical tray interface directly; .\broglow.exe opens the terminal dashboard.

To build the app from a source checkout instead (Rust 1.90+):

cargo install --locked --path .
"$HOME/.cargo/bin/broglow" install

On Linux, install the system development libraries before compiling; the tray's GTK 3 bindings have known advisories. On Windows, use the Rust MSVC toolchain, run cargo install --locked --path ., then broglow install. No board is flashed by app installation.

On macOS, press ⌘ Space, search BroGlow and press Return to open its controls. The app lives in ~/Applications/BroGlow.app. You can also run open "$HOME/Applications/BroGlow.app". In Terminal, broglow opens the optional terminal dashboard once ~/.cargo/bin is on PATH.

Connect your coding agents

Installation always registers Claude Code hooks and adds hooks for other agents it detects. Details per agent: Connect your coding agents.

AgentSetup note
Claude CodeHooks in ~/.claude/settings.json.
opencodeInstalled plugin; restart running sessions.
CodexCodex >= 0.144; approve hooks via /hooks. Connect Codex.
GitHub Copilot CLIInstalled hooks; restart sessions open during installation.

Cloud tasks and ordinary ChatGPT conversations do not trigger this Mac's local hooks.

Use it

Click the menu-bar or tray icon for sessions. On macOS, Lamps adds a lamp (USB-assisted Bluetooth setup), names it or adjusts its brightness; multiple saved lamps work independently. On Windows and Linux, the lamp is connected over USB. Session × hides a row until new activity; the conversation stays in its coding app.

broglow --version               Identify the installed release
broglow                         Open the terminal dashboard
broglow ble pair                Set up a flashed C3 over USB and pair it over Bluetooth (macOS)
broglow ble status              Check whether status reaches the lamp
broglow dashboard-button show   Show terminal-dashboard buttons in the tray app
broglow uninstall               Remove hooks, autostart, the app (macOS) and all BroGlow data

Needs input always wins (red); in Settings (macOS and Windows) choose whether mixed working and idle sessions show yellow or green.

Contributing

Bug reports, ideas, documentation improvements and code contributions are welcome. See the contributing guide to get started.

License

MIT. Release packages include third-party notices: the licenses of the Rust crates the app is built from and the Rust standard library notices; Mac packages also list the firmware's linked libraries and their licenses. See the media policy for project images.

// faq

What is broglow?

Desk traffic light for AI coding agents: menu-bar app, terminal dashboard and DIY ESP32-C3 lamp for Claude Code, Codex, opencode and Copilot CLI.. It is open-source on GitHub.

Is broglow free to use?

broglow is open-source under the MIT license, so it is free to use.

What category does broglow belong to?

broglow is listed under automation in the Claudeers registry of Claude-compatible tools.

21 views
★ 14 stars
unclaimed
updated 28 days ago

// embed badge

broglow on Claudeers
[![Claudeers](https://claudeers.com/api/badge/broglow.svg)](https://claudeers.com/broglow)

// retro hit counter

broglow hit counter
[![Hits](https://claudeers.com/api/counter/broglow.svg)](https://claudeers.com/broglow)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 260,254◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 110,676◷ MIT[ claude ]
→ see how broglow connects across the ecosystem