dsh-caps-beacon
DeepSeek Harness 的 Caps Lock LED 状态指示灯：根代理工作时常亮，需要你批准/回答或一轮执行失败时闪烁，空闲时熄灭。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xinyang920/dsh-caps-beacon#9c7738f7b9873e3954a3284863be4fda58b2ec58Caps Beacon 以 dsh-caps-beacon 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
Use the Caps Lock LED on your MacBook as a status light for DeepSeek Harness — a DSH-native take on Mac-Agent-Beacon.
Solid = working · Fast blinking = needs your attention · Off = idle
When you send DSH off to work in the background, you can stop switching back to check on it: a glance at the keyboard tells you everything.
| Host state | LED |
|---|---|
| A root agent is running (tools, model calls, retries) | solid |
| An approval request is waiting for you | blinking |
An ask_user_question prompt or plan review is waiting for your answer | blinking |
A root turn ended in error or blocked (latched until the next turn starts) | blinking |
| Idle | off |
Attention always wins over working: the moment an approval is resolved, the
light returns to solid. Subagents and background children stay silent by
default (rootsOnly) so parallel fan-outs don't strobe your keyboard.
The plugin is a pure observer: the approval/request and tools/execute
listeners delegate through next() and never decide anything. It writes the
LED only — no key presses, no keyboard remapping, no approval-policy changes.
On exit, the helper restores the physical light to the current logical Caps
Lock state.
DSH host events ──▶ plugin state machine ──▶ beacon-led (C) ──▶ Caps Lock LED
agent/status,
approval/request, tools/execute, and session/event. No internal
interfaces are reverse-engineered, so nothing silently breaks when the
agent stack updates.native/led.c, adapted from
CapsPulse via Mac-Agent-Beacon, both
MIT) drives the built-in keyboard's Caps Lock LED through macOS
IOKit/IOHID output elements. The plugin keeps one beacon-led serve child
alive and writes 1/0 bytes to its stdin; blinking is a timer in the
plugin.xcode-select --install) for the one
make step.dsh)
with a profile — tested with web.# 1. Add the plugin to your profile (any profile works, `web` shown here).
dsh plugin --profile web add github:xinyang920/dsh-caps-beacon
# 2. Build the LED helper where pnpm placed the package.
cd ~/.dsh/profiles/web/node_modules/dsh-caps-beacon && make
# 3. Restart dsh web — bundle membership is read at startup.
Step 1 registers the bundle in dsh.profile.bundles automatically. Step 2
compiles build/beacon-led (about one second; the installer deliberately
does not run compiled code for you). Step 3 is required because plugins load
at boot.
On most machines the helper can write the LED with no extra authorization. If yours blocks it:
./build/beacon-led inspect — it explains the failure when access is
denied.Cmd-Shift-G, and enter the absolute path of
dsh-caps-beacon/build/beacon-led inside your profile's node_modules.dsh web.# The helper finds the keyboard and LED element:
./build/beacon-led inspect
# {"keyboard":"Apple Internal Keyboard / Trackpad","led_output":true,...}
# The helper process is alive while dsh runs:
pgrep -fl beacon-led
Then give any task to a session: the LED goes solid while it runs. The
easiest blink test is to ask the agent a question that makes it call
ask_user_question — the LED blinks while the prompt waits for you.
Helper failures and unexpected exits are logged under the
[dsh-caps-beacon] prefix in the dsh log.
Override the row by id dsh-caps-beacon in your profile's
cordis.patch.yml (a patch replaces the row's whole config, so restate
what you own):
- id: dsh-caps-beacon
config:
enabled: true
ledPath: "" # absolute path to beacon-led; default: bundled build/beacon-led
blinkIntervalMs: 250
rootsOnly: true # ignore subagents and background children
verbose: false # log every mode change
triggers:
approval: true # approval/request pending
question: true # ask_user_question / exit_plan_mode pending
error: true # turn ended in error/blocked
pgrep -fl beacon-led while dsh runs. No
process means the plugin did not load: confirm dsh-caps-beacon appears in
dsh.profile.bundles (~/.dsh/profiles/web/package.json) and restart.
A process with a dark LED usually means an external keyboard or Karabiner
is involved: Karabiner-Elements can block LED access when it grabs the
built-in keyboard exclusively.[dsh-caps-beacon] helper restarted after failure. If the LED stays dark
past a minute, restart dsh web.make fails — install Xcode Command Line Tools
(xcode-select --install) and retry.make in the
package directory) so the helper binary matches, then restart.dsh plugin --profile web remove dsh-caps-beacon
Also remove dsh-caps-beacon from dsh.profile.bundles in
~/.dsh/profiles/web/package.json if your dsh version did not, then restart.