git404hub

what is emberglow-keyboard fr?

emberglow-dev/emberglow-keyboard — explained in plain English

Analysis updated 2026-05-18

8PythonAudience · developerComplexity · 2/5Setup · easy

tl;dr

A CLI that makes your Keychron keyboard glow different colors depending on whether Claude Code, Codex, or another AI agent is working, waiting, or done.

vibe map

mindmap
  root((emberglow))
    What it does
      Keyboard status light
      Working blue
      Needs you amber
      Done green flash
    Tech stack
      Python
      QMK
      VIA protocol
    Use cases
      Ambient agent status
      Claude Code hooks
      Codex CLI notify
    Audience
      Developers
      Keychron owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Get an ambient visual signal for when your AI coding agent is running, waiting, or done, without checking the terminal.

VIBE 2

Wire up Claude Code, Codex CLI, or Antigravity hooks to change your keyboard's lighting on lifecycle events.

VIBE 3

Add support for a new VIA enabled QMK keyboard by finding its effect indices with the built in probe command.

what's the stack?

PythonQMKVIA protocolHID

how it stacks up fr

emberglow-dev/emberglow-keyboard100/awesome-machine-learningadam-s/car-diagnosis
Stars888
LanguagePythonPythonPython
Last pushed2024-08-07
MaintenanceStale
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Only tested on a wired Keychron Q10, other QMK boards need manual effect index discovery.

in plain english

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.

prompts (copy fr)

prompt 1
Help me install Emberglow and connect it to my Claude Code hooks in settings.json.
prompt 2
Show me how to find the breathing and solid effect indices for my QMK keyboard with emberglow probe.
prompt 3
Write the Codex CLI notify script that turns on Emberglow's needsyou state when a turn completes.

Frequently asked questions

what is emberglow-keyboard fr?

A CLI that makes your Keychron keyboard glow different colors depending on whether Claude Code, Codex, or another AI agent is working, waiting, or done.

What language is emberglow-keyboard written in?

Mainly Python. The stack also includes Python, QMK, VIA protocol.

How hard is emberglow-keyboard to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is emberglow-keyboard for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.