Apache-2.0 · local only

Turn status into light.

AgentBeacon watches the status reported by coding agents, aggregates idle / working / waiting / error into one semantic state, and drives a USB status light. The Rust service, React console and Tauri desktop app all run on your machine.

Read the docs Download View source

Apache-2.0 · No private edition · No cloud service

agent-beacon · 127.0.0.1:6980local

working

3 active sessions

Devices

MLight 3-LEDUSB CDC

YH50-RGY-Jbuzzer

States

idle4
working3
waiting1
error0

no cloud · no telemetry

aggregated states

device profiles

cloud accounts

STATES

Four states, one light signal

Live status from multiple agent sessions is aggregated into one current state, then mapped to a light effect.

idle

No active sessions; the light returns to standby.

working

At least one agent is working; the light goes active.

waiting

A session is waiting for input or an external result.

error

A session reports an error; the light gives a clear warning.

DEVICES

Give the state to a light

Common USB status lights are discovered automatically; a mock device covers hardware-free testing.

MLight single

USB CDC

RGBbrightness

MLight 3-LED

USB CDC

RGBbrightness

YH50-RGY-J

USB serial

tri-color LEDbuzzer

mock

virtual

hardware-free

INTEGRATIONS

Every agent can report

Pi, OpenCode and DeepSeek Harness are built in; Claude Code uses hooks, other agents use CLI or HTTP.

Extension

agent-beacon integrate install pi

OpenCode

Plugin

agent-beacon integrate install opencode

DeepSeek Harness

Cordis plugin

agent-beacon integrate install dsh

Claude Code

Hooks

hooks configuration

Other agents

CLI / HTTP

agent-beacon report

LOCAL FIRST

No service required

The service listens on 127.0.0.1:6980. No account, no telemetry, no dependency on QuadHub or any external service.

Local Rust service
Browser console
Tauri desktop app
Mock device testing

agent-beacon
# open http://127.0.0.1:6980
agent-beacon integrate install pi

Linux / macOS / Windows builds are on Releases; you can also build from source.

127.0.0.1:6980

One light, one local service, no cloud account.

idle

working

waiting

error

MANUAL

Manual

Device support, agent integrations, the local service and reference details.

Read the docs

Overview

Overview

Quick start

Quick start

Devices

Supported devices

Integrations

Agent integrations

Reference

Local service reference

LOCAL STATUS SIGNAL

Make the state visible

Run locally, plug in a light, and start without a cloud account.

Read the docs View source