latent-spaces/cled

CLED, short for Claude slash Codex LED, is a small background program that turns an RGB keyboard into a live status display for your AI coding agents. Instead of switching windows to check whether Claude Code or Codex is still working on something, you glance down at the keyboard and read the colors: which agent session is busy, which one is waiting on you, and how hard your machine's CPU and memory are working. It runs through OpenRGB, an open source tool that controls RGB lighting on many keyboard brands. CLED lights up different areas of the keyboard for different information. The function key row fills left to right to show memory usage. Number keys one through nine each represent one agent tab in the currently focused iTerm2 window, colored red for busy, green for idle and waiting on you, amber for idle longer than 20 minutes, and blue for a tab that is not a recognized agent. The numpad shows per core CPU load shifting from green to yellow to red as load rises, and the enter key pulses through a rainbow pattern as a heartbeat to show the daemon itself is still running. It only works on macOS, because it detects which agent is running by reading the focused iTerm2 window through AppleScript. You also need OpenRGB installed, Python 3.11 or newer managed with the uv tool, and a keyboard that OpenRGB supports. It was built and tested against a Corsair K70 RGB MK.2 SE keyboard, but should work with other boards where the LED names match. The easiest way to run it is a single command through uv, which downloads and runs it without a permanent install, though a persistent command line tool and a Claude Code plugin that checks your setup and launches the daemon are also available. The whole project stays small on purpose: three short files handle talking to OpenRGB, watching terminal tabs to figure out agent status, and running the display loop at 10 frames per second, with just two external dependencies. Because it is so compact, the author encourages people to fork it and adjust it for their own keyboard layout, color choices, or a different terminal and agent setup, suggesting you can simply ask Claude to make the changes you want.