THE IDEA
The room tells me what Claude is doing.
Claude Code can work for minutes at a time, and then stop to ask for permission. lightxp turns the LED strip in my room into a status light, so I can look away from the screen and still know when it’s my turn.
I saw someone do something like this with an LED desk lamp, and wondered if the LED strip I already had could do it too. I took a photo of the strip’s power adapter, shared it with Claude along with a GitHub repo for that kind of strip, and set it up. It’s been working since.
WHAT IT SHOWS
Working
Amber, solid, from the moment a prompt is sent.
Needs you
Purple, breathing. Only for a permission request.
Finished
Two green blips, then back to waiting.
Waiting
Dim blue. Your turn, nothing urgent.
No session
Off, once the last Claude window closes.
TRY IT
A small copy of the light. Send it the same events Claude Code does.
waiting: dim blue
CHOICES I MADE
Only one notification means “now”
Claude Code sends the same kind of notification for “I need your permission” and “you’ve been idle for 60 seconds”. Treating both as urgent would turn the light purple all day, and I would learn to ignore it. The light reads the message and only a permission request turns it purple.
Unknown means urgent
If the wording is new, the light treats it as urgent. A purple light that wasn’t needed is a nuisance; a permission prompt nobody saw stalls the work. Every message is logged, so the matching can be checked against what Claude Code really sends.
Manual control sticks
Pick a colour or turn the strip off from the menu bar, and Claude stops driving it until you hand it back. Otherwise Claude’s next step would override you a second later.
Two windows, one light
Each Claude session is counted. One window finishing doesn’t make the light say “waiting” while another is still working. Windows that vanish without saying goodbye are dropped after 15 minutes.
Your typing never waits for Bluetooth
Connecting to the strip takes a second or two, and the hook runs before each message is sent. So the hook only drops a note to a small background program in about 20 ms, and that program holds the one Bluetooth connection.
No tokens, nothing leaves the Mac
Hooks are shell commands the app runs on events, so the AI model is never asked. Of everything Claude Code hands the hook, the light reads only the session id and the notification text. No network code at all.
THE MENU BAR
An icon at the top of the screen shows the same state, for when the strip is out of sight. Clicking it lets me take control, set a colour or brightness, or change what each state looks like: 11 colours, and an effect each (solid, blink, breathe, blip twice or off). Changes apply on the spot.
THE HARDWARE
A generic Bluetooth LED controller, the white box with a QR code that comes with cheap strips (Keepsmile KS03). It has no official way in. Its protocol was already worked out by someone else: a handshake, power on, power off, and one command that sets a colour and brightness. That is all the light needs.
5A 00 01 FF 50 00 00 55 00 A5 · amber, sent when you press enter
HOW IT WENT
- Sep 2026Built in two days: the background program, the hooks, the menu bar app. Started on every login.
- Sep 2026The idle nudge was turning the light purple. Notifications are now read and logged, and only permission requests count.
- Nov 2026Still running every day.
WHAT I LEARNED
It’s quicker and more straightforward to build something with Claude when there’s already a repo that does the core job.
WHAT CLAUDE LEARNED
Claude, the AI that wrote the code with me, in its own words.
Hardware fails silently
Started at login by macOS, the background program hung forever looking for the strip, with no error at all. Bluetooth permission belongs to each process, and a program started outside your desktop session doesn’t get it. Now it runs inside the session, and every connection attempt has a time limit.
The strip takes one partner
Two copies of the background program don’t share the light; neither connects. Each part now holds a lock so only one copy can ever run.
Wording is not an interface
The light decides what is urgent by reading the notification’s text, which Claude Code can change at any time. So every message is logged, and anything unfamiliar falls on the safe side.
CREDIT
Controller protocol: Keepsmile KS03 protocol notes by SaturnKai.