The Claw Light

The Claw Light is an ESP32-based LED that sits on your desk and glows the current ClawLight CLI status color. The ClawLight CLI already supports driving an ESP32 status indicator, so the lamp is a drop-in display for the status you're already tracking.

What's inside

• A Seeed Studio XIAO ESP32-C6 microcontroller
• An addressable RGB LED diffused behind the dome
• USB-C for power and data — the ClawLight CLI drives it over USB serial

1. Flash the firmware

Connect the Claw Light over USB-C and flash the latest firmware. The firmware sources live in the separate clawlight-firmware repository — its scripts/flash.sh builds and flashes the board in one step.

2. Pair it with the ClawLight CLI

Plug the light into your machine over USB-C, open the dashboard, and press l to enable status LEDs:

clawlight

That's it — the menu-bar daemon drives the light from then on, automatically reconnecting when you replug it and surviving reboots. Press l again to turn it off.

The lamp should immediately reflect your current aggregate status.

3. Test it

Trigger a state change — start a Claude Code session, or ask an agent something that requires your approval — and watch the light move through the status colors.

Configuration

Common options:

• clawlight led — run the LED driver in the foreground for debugging; add --port <device> to pin a specific serial device
• led_port in ~/.claude/clawlight/config.json — pin the device permanently if your board isn't auto-detected
• clawlight update <firmware> — push new firmware over the same serial link, no cable reflash needed

Having trouble? See troubleshooting.