Agent Status Light

Local hardware for coding agents

Physical status for agent work.

Agent hooks enter the desktop runtime. The desktop app verifies firmware and mirrors state to an ESP32 red / yellow / green signal light.

Download desktop app Get firmware image Read hardware guide

给 coding agent 用的本地硬件

把 agent 状态变成桌面旁边的物理信号灯。

Agent hooks 进入桌面 app，本地 runtime 校验固件并把状态同步到 ESP32 红黄绿信号灯。

下载桌面 app 获取固件文件 阅读硬件指南
Waiting等待确认

User confirmation is needed.需要用户确认时亮起。

red solid红色常亮
Thinking / Running思考中 / 运行中

Planning or tools are active.Agent 正在规划或工具正在执行。

yellow blink黄色闪烁
Idle空闲

The agent is ready.Agent 已就绪时亮起。

green solid绿色常亮
  1. Agent hooksAgent hooks agent-status-light hook
  2. Desktop app桌面 app 127.0.0.1:8765
  3. ESP32 firmwareESP32 固件 agent-status-light-v1
  4. Signal light信号灯 R/Y/G GPIO

Installable app

Direct app downloads use formal Release assets. agent-status-light_darwin-arm64.dmg

Manifest verified

Firmware flashing uses the merged bin and matching manifest. merged bin + manifest

Formal versions only

RC/prerelease assets stay out of the public download path.

Hardware kit

Coming soon. Purchase links are not live yet.

可安装桌面 app

直接下载只使用正式 Release assets。 agent-status-light_darwin-arm64.dmg

Manifest 校验

固件刷写使用 merged bin 和匹配 manifest。 merged bin + manifest

仅正式版

RC/prerelease 不进入普通用户稳定下载路径。

硬件套件

即将开放，不伪造购买链接。
Default signal states默认信号状态

Default signal states默认信号状态

Idle空闲

Green solid when the agent is ready.绿色常亮，表示 agent 已就绪。

idle
Thinking思考中

Yellow blink while the agent is planning.黄色闪烁，表示 agent 正在规划。

thinking
Running运行中

Yellow blink while tools are active.黄色闪烁，表示工具正在执行。

running
Waiting等待确认

Red solid when user confirmation is needed.红色常亮，表示需要用户确认。

waiting

Download desktop app

Download desktop app

Install the desktop app from GitHub Releases. The app owns local state, agent hooks, device setup, and firmware flashing.

Direct downloads

macOS agent-status-light_darwin-arm64.dmg Windows agent-status-light_windows-amd64_setup.exe Linux agent-status-light_linux-amd64.tar.gz
View release notes Download checksums
  • macOS agent-status-light_<version>_darwin-arm64.dmg
  • Windows agent-status-light_<version>_windows-amd64_setup.exe
  • Linux agent-status-light_<version>_linux-amd64.tar.gz

Checksums are published with release assets.

下载桌面 app

下载桌面 app

从 GitHub Releases 安装桌面 app。它负责本地状态、agent hooks、设备设置和固件刷写。

直接下载

macOS agent-status-light_darwin-arm64.dmg Windows agent-status-light_windows-amd64_setup.exe Linux agent-status-light_linux-amd64.tar.gz
查看发布说明 下载 checksums
  • macOS agent-status-light_<version>_darwin-arm64.dmg
  • Windows agent-status-light_<version>_windows-amd64_setup.exe
  • Linux agent-status-light_<version>_linux-amd64.tar.gz

Release assets 会同时发布 checksums。

Firmware image

Firmware image

Use the manifest-verified merged firmware image for ESP32-WROOM-32. Final users do not need Arduino IDE, arduino-cli, PlatformIO, ESP-IDF, or esptool.

Firmware downloads

Merged bin agent-status-light_esp32-wroom32-merged.bin Manifest agent-status-light_esp32-wroom32-manifest.json
  • Merged bin agent-status-light-esp32-wroom32-v<version>-merged.bin
  • Manifest agent-status-light-esp32-wroom32-v<version>-manifest.json

The desktop app checks manifest metadata, size, SHA-256, chip, format, and flash offset before flashing.

Firmware guide

固件文件

固件文件

ESP32-WROOM-32 使用经过 manifest 校验的 merged firmware image。最终用户不需要 Arduino IDE、arduino-cli、PlatformIO、ESP-IDF 或 esptool。

固件下载

Merged bin agent-status-light_esp32-wroom32-merged.bin Manifest agent-status-light_esp32-wroom32-manifest.json
  • Merged bin agent-status-light-esp32-wroom32-v<version>-merged.bin
  • Manifest agent-status-light-esp32-wroom32-v<version>-manifest.json

桌面 app 会在刷写前检查 manifest 元数据、大小、SHA-256、芯片、格式和刷写偏移。

固件指南

Setup path

Setup path

  1. 1 Install app

    Open the desktop app directly after installing the package for your OS.

  2. 2 Flash firmware

    Choose the manifest or matching firmware image in the desktop app and confirm the preview.

  3. 3 Sync agents

    Use supported hook integrations so coding agent state reaches the local runtime.

设置路径

设置路径

  1. 1 安装 app

    安装对应系统的包后，直接打开桌面 app。

  2. 2 刷写固件

    在桌面 app 中选择 manifest 或匹配的固件文件，检查预览后确认。

  3. 3 同步 agent

    使用支持的 hook 集成，让 coding agent 状态进入本地 runtime。

Coming soon

Hardware kit

A ready-to-use kit is planned, but purchase links are not live yet.

Coming soon

即将开放

硬件套件

计划提供可直接使用的套件，但购买链接尚未开放。

即将开放

Debugging and documentation

Debugging and documentation

Keep the normal path short. Use these documents when you need wiring, firmware, hook, or release details.

Hardware guide docs/hardware.md Firmware guide docs/firmware.md Desktop app docs/desktop.md Release process docs/release.md Hook setup docs/hooks.md GitHub masiqi/agent-status-light

调试与文档

调试与文档

普通路径保持简短；需要接线、固件、hook 或发布细节时再进入这些文档。

硬件指南 docs/hardware.md 固件指南 docs/firmware.md 桌面 app docs/desktop.md 发布流程 docs/release.md Hook 设置 docs/hooks.md GitHub masiqi/agent-status-light

When something does not light up

When something does not light up

  • Check USB or Bluetooth serial selection in the desktop app.
  • Reset the ESP32, then run firmware status and Devices Test.
  • If status is verified but colors are wrong, inspect GPIO mapping, channel order, and polarity.

如果灯没有按预期亮起

如果灯没有按预期亮起

  • 先在桌面 app 中检查 USB 或蓝牙串口选择。
  • 重置 ESP32，然后运行 firmware status 和 Devices Test。
  • 如果状态已验证但颜色不对，检查 GPIO mapping、通道顺序和极性。