CCChroma

Map Claude Code activity to Razer Chroma keyboard RGB lighting. See AI work state at a glance.

What it does

CCChroma runs a local HTTP server (localhost:9898) that listens to Claude Code via official hooks and translates events into Chroma lighting effects:

• 🟦 Idle — gentle deep-blue breath
• 🟩 Thinking — slow cyan breath
• 🌊 Streaming — flowing aquamarine wave
• 🟧 Tool call — quick orange flash
• 🟥 High context — orange heartbeat on top of streaming
• 🚨 Error — red pulse
• 🟪 Paused — solid purple

A bundled Web UI at http://localhost:9898 lets you tweak colors and toggle states in real time. A live status light on the page mirrors what was sent to your keyboard, so you can verify the round-trip.

Install

npm install -g ccchroma

Requires Windows 10+ with Razer Synapse + Chroma Workshop installed.

Quickstart

ccchroma enable     # inject hooks + Task Scheduler autostart
ccchroma daemon     # start server in background
ccchroma open       # open the Web UI in your default browser

Use Claude Code normally. Your keyboard now lights up with its state.

Commands

| Command | Purpose | |---|---| | ccchroma start | Foreground server (dev/debug) | | ccchroma daemon | Background server (Task Scheduler managed) | | ccchroma enable | Inject hooks + register autostart | | ccchroma disable | Remove hooks + autostart | | ccchroma open | Open browser to Web UI | | ccchroma doctor | End-to-end self-check |

Troubleshooting

• No lights? Run ccchroma doctor. The Chroma line should be ✓. If ✗, ensure Razer Synapse is running.
• Browser doesn't open? Visit http://localhost:9898 manually.
• Edit colors but keyboard doesn't change? Check the Web status light — if it updated but keyboard didn't, Chroma is offline.

License

MIT