emberglow-dev/emberglow-keyboard

Emberglow is a small tool that turns your keyboard's RGB lighting into a status light for AI coding agents. It talks to a Keychron Q10 keyboard over the VIA protocol, the same low level connection VIA's own configuration app uses, so no extra software or background service is needed, aside from making sure the VIA app itself is closed while Emberglow runs. The idea is simple: your keyboard glows blue while an agent like Claude is working, flashes green and returns to normal once it finishes, breathes amber if it needs your input or approval, and turns solid red if something failed. It was built with Claude Code in mind, but the command line tool itself, emberglow set state, just runs a shell command, so any tool that can fire a command on a lifecycle event can drive it. The README shows working examples for Claude Code hooks, OpenAI Codex CLI's notify system, Google Antigravity's hook system, and Anthropic's webhook based Managed Agents. Right now only the Keychron Q10 is officially tested, though the author says any VIA enabled QMK keyboard should work in principle, since the lighting engine itself is not tied to one specific board. Getting a new board working means using the built in enumerate and probe commands to find its USB identifiers and figure out which lighting effect index corresponds to solid versus breathing light, then setting those as environment variables. Setup involves cloning the repository, creating a Python virtual environment, and installing with pip. Python 3.10 or newer is required. For Claude Code, hooking it up is just a few lines added to a settings.json file mapping prompt submission to working, notifications to needsyou, and session stop to done. The project notes a few real gotchas along the way, such as Windows paths needing forward slashes inside hook commands, and Codex CLI currently only exposing a single lifecycle event rather than a full set.