Agent Status Light

Local hardware for coding agents

Agent Status Light

A physical status light for coding agents and local developer workflows.

Download desktop app Get firmware image Read hardware guide

给 coding agent 用的本地硬件

Agent Status Light

面向 coding agent 和本地开发工作流的物理状态灯。

下载桌面 app 获取固件文件 阅读硬件指南
  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
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.

Latest GitHub Release
  • 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、设备设置和固件刷写。

最新 GitHub Release
  • 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.

  • 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-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、通道顺序和极性。