claudeled 0.9.0-beta

Blinks the Caps Lock LED on your keyboards while a Claude Code session is waiting for
you. Several sessions in several windows aggregate: any one of them waiting is enough
to light the lamp.

It writes to the keyboard's LED element directly, so the Caps Lock modifier is
never asserted and your typing case is unaffected.

Install

Download claudeled-0.9.0-beta.zip, unzip, move claudeled.app to /Applications,
then clear the quarantine flag:

xattr -dr com.apple.quarantine /Applications/claudeled.app
open /Applications/claudeled.app

Without that, macOS refuses to open it: the app is ad-hoc signed rather than notarised,
and anything arriving through a browser is quarantined. The alternative is to launch it,
let it be blocked, and allow it in System Settings → Privacy & Security → Open Anyway.

Or build it yourself and skip Gatekeeper entirely:

git clone https://github.com/odiumuniverse/claudeled && cd claudeled && make install

First launch

It installs its Claude Code hooks into ~/.claude/settings.json — merged, with a
backup, leaving your other hooks alone — and asks for Input Monitoring, which macOS
requires before any process may touch a keyboard's LED. Grant it and the app restarts
itself.

Requirements

macOS 13 Ventura or newer.

Checksum

SHA256  873de1da23e0c79bb3c44ef1d830c10e9dcddacd61641d73ad59a445d33b0284

Known limitations

This is a beta.

• Ad-hoc signed, not notarised, so every download needs the quarantine step above.
• Verified on the MacBook internal keyboard (SPI) and Magic Keyboard 2 (Bluetooth).
  Other keyboards are handled generically — if one exposes a Caps Lock LED element it
  can be driven, and claudeled test <name> tells you in three seconds.
• Rebuilding from source changes the ad-hoc signature, which voids the Input Monitoring
  grant. make install clears the stale grant so macOS asks again.