What is cursor_agent_status_light?

CursorLight turns a cheap toy traffic light into a physical status indicator for Cursor Agent, an AI coding assistant. When the AI is thinking through a problem, a scrolling light pattern runs across the red, yellow, and green bulbs. When it finishes successfully, the green light stays solid. When something goes wrong, the red light flashes rapidly. The whole point is to give you a glanceable, physical signal about what the AI is doing without looking at your screen. The hardware side is a small do-it-yourself project. You buy a toy traffic light, a tiny microcontroller called the ESP32-C3 SuperMini, three resistors, and some wire. You solder the microcontroller into the toy so it controls the three colored bulbs, then upload the firmware using the free Arduino IDE software. The microcontroller communicates with your computer over Bluetooth, so no Wi-Fi is required and your computer stays connected to whatever network it was already using. On the computer side, a Python script sends short text commands over Bluetooth to change the light mode. The supported modes include thinking, busy, success, error, alarm (a flashing red-yellow alternation for serious problems), and a few others for testing individual bulbs. The script uses a library called Bleak to handle the Bluetooth connection on both macOS and Windows. The project also ships with a set of Cursor Hooks, which are scripts that Cursor Agent runs automatically at different points in its workflow. When the agent starts analyzing a problem it triggers the thinking light, when it runs a terminal command it triggers busy, when the task completes it triggers success or error. A debounce layer called ble_gate.py prevents multiple hooks firing at the same time from causing the light to flicker unpredictably. The firmware has a built-in timeout so the light does not stay on indefinitely. Most modes run for up to five minutes before switching to a traffic-light demo pattern, and that demo pattern turns off after ten minutes. Installation guides for both macOS and Windows are included in the repository.