ハードウェア
LED10個、配線1本、ダッシュボードなし。
Agent Andon Lightがフックイベントを光に変える仕組みを、基板・通信プロトコル・ファームウェア（チップの中で直接動くプログラム）のレベルで見ていきます。
実際に机の上にあるもの
小型の基板（Waveshare RP2040-Zero）を専用基板にハンダ付けし、3Dプリントの拡散カバーの奥で10個のアドレサブルWS2812B LEDを駆動します。USB-Cケーブル1本で電源とシリアル通信の両方をまかない、別電源もワイヤレスペアリングも不要です。設定が必要なのは、CLI（コマンドを打って操作する、ボードと通信するプログラム）をインストールすることだけです。
1文字が、1つの色になる。
ホストCLIはUSBシリアル経由でファームウェアと通信します。プロトコルはほぼ最小構成：ASCII文字1つと改行だけ。JSONもハンドシェイクもありません。
通信プロトコル
| コマンド | 動作 | 意味 |
|---|---|---|
| G | 緑点灯 | エージェントが作業中 |
| Y | 黄点灯 | あなたの対応待ち |
| R | 赤点灯 | アイドル / 停止 |
| C | 順次点灯 | コンパクト中 |
| H | 変化なし | ハートビート |
見ていない時こそ、信頼できるように。
ファームウェア自体が30分のウォッチドッグタイマーを持っています。ホストからの通信が途絶えると、赤色のセクションは点灯したままではなく、ゆっくり明滅するパルスに切り替わります。離席中も信頼できるステータスライトであるためには、静かに固まるのではなく、目に見える形で異常を伝える必要があります。
Claude CodeとCodex CLIに直結。
Claude CodeとCodex CLIのフックは、CLIを1件ずつ順番に、前の処理が終わるのを待ってから呼び出します。だからこそ、ツール呼び出しが連続する場面でも、ライトは常に本当の出来事の順序を反映します。
| フックイベント | 色 |
|---|---|
| SessionStart | アイドル |
| UserPromptSubmit / PreToolUse | 作業中 |
| Notification / PermissionRequest | 待機中 |
| PreCompact | コンパクト中 |
| Stop / SessionEnd | アイドル |
隠しごとなし。
回路図からファームウェア、ホストCLI、インストールされるフック設定まで、すべてMITライセンスで公開しています。自分で組み立てたい方向けに、部品表と組み立てガイドもドキュメントに揃えています。
GitHubで見るWindows版インストーラーは署名されていません。署名を取得するまでは、実行するたびにWindowsが警告を表示します。macOSは未検証で、公式にはサポートしていません。企業ではなく個人が開発・保守しています。IssueやPull RequestはGitHubで歓迎します。