dsh-tab-status-light: Painting DeepSeek Harness Session State onto the Tab Icon

What Does It Do?

Tab Status Light is a DSH plugin for DeepSeek Harness that paints the AI session state onto the browser tab icon. It solves the problem of losing track of an agent once you switch to another tab: the icon blinks gray while a turn runs, turns green when the turn finishes, turns yellow while the session waits for you, and turns red when a turn is interrupted. You can read the agent's state at a glance from any tab without switching back to the app.

Core Features

• Four-state color mapping: gray blinking means a turn is running, green means it just finished, yellow means the session is waiting for your answer (question, approval, or plan review), and red means the turn was interrupted.
• Background-safe blinking: the pulse is driven by a tiny Web Worker, so it keeps blinking while the tab is hidden instead of being throttled by page timers.
• Live favicon redraw: the plugin reads the current favicon and splices a status dot into it, so the whale artwork is never copied and upstream logo changes carry over automatically.
• No history replay: switching to a session that finished long ago leaves the icon untouched; green and red report what just happened, and an interruption keeps the tab red for its full 20 seconds even if the next turn finishes inside that window.
• Tunable constants: dot position, radius, ring width, and the 10-second green / 20-second red settle times are all set at the top of the client script.

How to Use This Plugin?

After enabling it in the DSH Web UI and reloading the page, the plugin takes over the tab icon automatically with no further action. Then just run conversations as usual: watch for the gray blink while a turn runs and the green light when it ends; a yellow icon means the session is waiting for your confirmation or answer. To change the dot size or settle durations, edit the constants at the top of the client script and reload the page.

How to Troubleshoot This Plugin?

The plugin relies on the harness Web profile plus the session client capabilities; if the icon never changes, first confirm you are on the Web profile and that those session client capabilities are available (a standard install includes them). If the blink looks uneven or stops in the background, check whether the browser supports Web Workers, since the plugin falls back to a page timer where workers are unavailable and background blinking may fail. If the icon does not update after installing, reload the page as described in the official instructions.