What is codex-hue?

codex-hue turns a room of Philips Hue smart lights into a status light for Codex, the AI coding assistant. While Codex is working on a task the room turns blue. When a task finishes the lights pulse green, then either return to blue if other tasks are still running, or restore every light back to whatever state it was in before. The tool connects to your Hue Bridge over your local network using its official local API, so nothing leaves your home network once it is set up. It works by plugging into Codex's own hook system, which lets outside programs react when a task starts or stops. To use it you need Python 3.9 or newer on macOS or Linux, a working Codex install with hooks support, and a Philips Hue Bridge on the same network with at least one color capable light in a room or zone. Windows is not supported because the program relies on a Linux and macOS only file locking method to keep multiple tasks from interfering with each other. Setup is done through a command line tool. You install it into its own Python environment, run a setup command that finds your Hue Bridge and asks you to press its physical link button, pick which room or zone to control, test that it works, then install the Codex hooks. Other commands let you list rooms, switch rooms, check status, reset a stuck state, or remove the hooks later. The tool is careful not to disturb any other hooks you already have configured. All of its settings and logs are stored outside the project folder in a hidden Codex configuration directory, and the file holding your Hue login is treated as a secret. This is a small hobby project built by an independent developer and is not connected to OpenAI or Philips Hue in any way.