Troubleshooting & FAQ

The light isn't changing color

1. Confirm mccm sees your sessions: run mccm and check the dashboard.
2. Confirm the integration is on: mccm light enable.
3. Confirm the light is reachable on your network (same Wi-Fi, correct IP).

The menu-bar icon is gray but I have sessions running

Gray means mccm sees no live sessions. If you do have Claude Code running, mccm may be watching the wrong state directory — restart it, or reinstall the login agent with mccm install --login.

The light is stuck red

Red means a session is waiting on you. Open the TUI (mccm) to find which session needs input; once you respond, the color clears automatically.

It won't connect to Wi-Fi

• The ESP32 supports 2.4 GHz networks. 5 GHz-only SSIDs won't work.
• Re-trigger setup mode by power-cycling the light and rejoining its setup network.

FAQ

Does this work on Windows or Linux? mccm's menu-bar daemon is macOS-only today, but the light is driven over the network — follow the mccm repo for other platforms.

Can I use my own ESP32? Yes. The firmware is open source; flash it onto a compatible board and pair it the same way.

Can multiple machines drive one light? Run mccm on each machine; the most urgent status wins.