What is vibe-light?

Vibe Light connects a Yeelight smart light strip to an AI coding assistant so the light's color and pattern reflect what the assistant is currently doing. It listens for hook events, which are status signals that some AI coding tools can send out as they work, and translates those signals into specific lighting effects on the physical light strip sitting on your desk. The mapping is straightforward: when the assistant is thinking or actively running a task, the light shows a blue purple breathing glow. When the assistant is waiting for you to approve an action, the light turns solid magenta. When a task is finished or the assistant is idle, the light turns solid white. A manual reset command clears the current state and returns the light to idle. Because more than one task can be running at once, the tool aggregates all of the current statuses together so the light does not flicker or jump erratically between colors when multiple things are happening. Setting it up requires Python 3 and the Yeelight Python package, plus enabling LAN control for the light strip through the Yeelight app so the script can talk to it directly over the local network, using an IP address you set in the script's configuration. To connect it to an assistant, you merge a provided hook configuration file into that assistant's own hook settings, pointing each hook event at the status script. The README documents this specifically for Codex, showing how to place the files in a Codex configuration folder and enable hook permissions from within Codex, though the underlying mechanism, watching hook events and driving a Yeelight bulb, is generic enough to be wired into any AI coding tool that supports similar hooks. It also includes commands for triggering each light state manually, for testing the setup.